fix: 修复系统更新 API 路由和改进健康检查逻辑

- 修复 /api/update/execute 404 错误，改为 /api/update/update - 增加健康检查等待时间从30秒到90秒 - 后端日志输出到文件，便于诊断问题 - 每5秒检查一次后端进程状态 - 改进错误诊断信息，区分进程退出和健康检查失败 - 记录后端启动日志的最后100行用于问题排查
feat: 改进系统更新健康检查逻辑
2026-01-21 11:53:30 +08:00 · 2026-01-21 11:31:19 +08:00 · 2026-01-21 05:30:48 +08:00 · 2026-01-21 05:18:42 +08:00 · 2026-01-21 05:13:28 +08:00 · 2026-01-21 04:52:32 +08:00
206 changed files with 27993 additions and 5668 deletions
@@ -5,391 +5,62 @@ path: backend/**
 # 后端开发规范
-## 代码完成规范
+## 核心原则
-
+- **禁止**在代码中添加 TODO/FIXME/XXX 注释
-### TODO 处理规则
+- **禁止**返回 mock 数据或硬编码的假数据
- **禁止**在代码中添加 TODO 注释
+- **禁止**在 API 调用失败时返回默认值作为 fallback
- **必须**根据 TODO 的内容直接完成代码实现
+- 所有功能必须完整实现，确保代码可以正常运行
 - 如果遇到暂时无法完全实现的功能，应该：
  1. 实现一个可用的基础版本
  2. 添加清晰的注释说明当前实现的限制和后续改进方向
  3. 确保代码可以正常编译和运行
 - **禁止**使用 `// TODO: 实现XXX` 这样的注释
 - **禁止**使用 `// FIXME:` 或 `// XXX:` 这样的注释
 - 如果某个功能需要依赖外部资源（如 API、库等），应该：
  1. 先实现一个占位或模拟实现
  2. 在注释中说明依赖关系和实现方式
  3. 确保代码逻辑完整，不会因为未实现的功能而崩溃
 ### API 调用实现规则
 - **必须**查找相关的 API 文档或接口定义
 - **必须**根据 API 文档完成代码实现
 - **禁止**在 API 调用处添加 TODO 注释
 - **禁止**直接返回 mock 数据或硬编码的假数据
 - **必须**调用真实的 API 或查询真实的数据库
 - 如果 API 文档不完整，应该：
  1. 查找项目中已有的类似 API 调用作为参考
  2. 查看 API 接口定义（如 `PolymarketClobApi.kt`）
  3. 查看 API 文档（如 `docs/polymarket-api-reference.md`）
  4. 实现一个可用的版本，包含错误处理
 - 如果 API 调用失败，应该：
  1. 返回明确的错误信息
  2. 记录错误日志
  3. 返回错误响应，而不是返回 mock 数据
 ### 代码完成示例
 ```kotlin
 // ❌ 错误：添加 TODO 注释
 fun getAccountBalance(accountId: Long?): Result<AccountBalanceResponse> {
    // TODO: 调用 Polymarket API 查询余额
    return Result.success(AccountBalanceResponse(usdcBalance = "0"))
 }
 // ✅ 正确：查找 API 文档并完成实现
 // 1. 查找 API 接口定义：PolymarketClobApi.getActiveOrders()
 // 2. 查找 API 文档：docs/polymarket-api-reference.md
 // 3. 实现完整的 API 调用逻辑，调用真实的 API
 fun getAccountBalance(accountId: Long?): Result<AccountBalanceResponse> {
    return try {
        val account = getAccount(accountId) ?: return Result.failure(IllegalArgumentException("账户不存在"))
        // 如果账户没有配置 API 凭证，返回错误而不是 mock 数据
        if (account.apiKey == null || account.apiSecret == null || account.apiPassphrase == null) {
            return Result.failure(IllegalStateException("账户未配置 API 凭证，无法查询余额"))
        }
        // 解密 API 凭证并创建认证客户端
        val apiKey = cryptoUtils.decrypt(account.apiKey!!)
        val apiSecret = cryptoUtils.decrypt(account.apiSecret!!)
        val apiPassphrase = cryptoUtils.decrypt(account.apiPassphrase!!)
        val clobApi = retrofitFactory.createClobApi(apiKey, apiSecret, apiPassphrase)
        // 调用真实的 API 查询余额
        val response = clobApi.getActiveOrders(limit = 100)
        if (response.isSuccessful && response.body() != null) {
            // 根据 API 响应处理余额数据（从真实响应中解析）
            val orders = response.body()!!
            // 实际应该调用余额查询接口或从链上查询
            // 这里只是示例，实际应该调用真实的余额查询 API
            val balance = queryRealBalanceFromApi(clobApi, account.walletAddress)
            Result.success(AccountBalanceResponse(usdcBalance = balance))
        } else {
            logger.error("查询余额失败: ${response.code()} ${response.message()}")
            Result.failure(Exception("查询余额失败: ${response.code()} ${response.message()}"))
        }
    } catch (e: Exception) {
        logger.error("查询账户余额失败", e)
        Result.failure(e)
    }
 }
 ```
 ## 需求文档引用
 ### 跟单系统需求
 - **需求文档**: `docs/copy-trading-requirements.md`
 - **说明**: 所有跟单系统相关的功能实现必须严格按照需求文档执行
 - **核心功能**:
  - 账户管理（通过私钥导入，支持多账户）
  - Leader 管理（被跟单者管理）
  - 订单同步与执行（监控 Leader 交易并自动复制）
  - 跟单配置管理（全局配置和单个 Leader 配置）
  - 风险控制（每日亏损限制、订单数限制等）
  - 跟单记录与统计
 **重要提示**: 在实现跟单系统相关功能时，请先查阅 `docs/copy-trading-requirements.md` 了解详细需求，包括：
 - 数据模型设计（Account、Leader、CopyOrder 等）
 - API 接口设计（请求/响应格式）
 - 业务规则和验证逻辑
 - 安全要求（私钥加密存储、API Key 管理等）
 ## 项目范围
-
+- **平台**: 仅支持 Polymarket
 ### 平台支持
 - **仅支持**: Polymarket 平台
 - **不支持**: 其他预测市场平台（如 Kalshi 等）
 ### 分类支持
 - **仅支持**: 
  - `sports`: 体育相关市场
  - `crypto`: 加密货币相关市场
 - **不支持**: 其他分类（如 politics、entertainment 等）
 ### 分类验证
 - 所有涉及分类的接口、实体、服务必须验证分类参数
 - 分类参数只能是 `sports` 或 `crypto`
 - 无效分类应返回明确的错误提示
 ## 包名规范
 - **包名**: `com.wrbug.polymarketbot`
 - 所有代码必须使用此包名
 ## 实体类规范
 ### ID字段规范
 - **必须**使用 `Long? = null` 作为 `@GeneratedValue` 的 id 字段
 - **禁止**使用 `Long = 0` 或其他默认值
 ```kotlin
 // ✅ 正确
@Entity
@Table(name = "example_table")
 data class ExampleEntity(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
-    val id: Long? = null,
+    val id: Long? = null,  // ✅ 正确：使用可空类型
-    // ...
+    
-)
+    @Column(name = "created_at", nullable = false)
-
+    val createdAt: Long = System.currentTimeMillis(),  // ✅ 使用 Long 时间戳
-// ❌ 错误
+    
-@Entity
+    @Column(name = "amount", nullable = false, precision = 20, scale = 8)
-data class ExampleEntity(
+    val amount: BigDecimal = BigDecimal.ZERO  // ✅ 使用 BigDecimal
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    val id: Long = 0,  // 禁止使用
    // ...
 )
 ```
 **规则**:
 - ID 字段必须使用 `Long? = null`
 - 时间字段使用 `Long` 时间戳（毫秒）
 - 数值字段使用 `BigDecimal`
 - **禁止**使用 `LocalDateTime` 或 `Double`
 ## 配置文件规范
-
+- **必须**使用 `application.properties` 格式（禁止 `application.yml`）
-### 配置文件格式
+- 使用 `${ENV_VAR:default}` 引用环境变量
 - **必须**使用 `application.properties` 格式
 - **禁止**使用 `application.yml` 格式
 - 配置文件位置: `src/main/resources/application.properties`
 ### 配置示例
 ```properties
 # 应用配置
 spring.application.name=polymarket-bot-backend
 # 数据源配置
 spring.datasource.url=jdbc:mysql://localhost:3306/polymarket_bot?useSSL=false&serverTimezone=UTC&characterEncoding=utf8mb4
 spring.datasource.username=${DB_USERNAME:root}
 spring.datasource.password=${DB_PASSWORD:password}
 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
 # HikariCP 连接池配置
 spring.datasource.hikari.maximum-pool-size=10
 spring.datasource.hikari.minimum-idle=2
 spring.datasource.hikari.connection-timeout=30000
 # JPA 配置
 spring.jpa.hibernate.ddl-auto=validate
 spring.jpa.show-sql=false
 spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
 # Flyway 配置
 spring.flyway.enabled=true
 spring.flyway.locations=classpath:db/migration
 spring.flyway.baseline-on-migrate=true
 # 服务器配置
 server.port=${SERVER_PORT:8000}
 # 日志配置
 logging.level.root=INFO
 logging.level.com.wrbug.polymarketbot=DEBUG
 logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss} - %msg%n
 ```
 ### 环境变量引用
 - 使用 `${ENV_VAR:default}` 格式引用环境变量
 - 支持多环境配置: `application-dev.properties`, `application-prod.properties`
 ## 代码规范
-### Controller规范
+### Controller
- Controller 方法**禁止**使用 `suspend`
+- **禁止**使用 `suspend`
- 如需调用 suspend 方法，使用 `runBlocking`（最小化使用）
+- 使用 `runBlocking` 调用 suspend 方法
- 只作用于 suspend 方法调用
+- 统一使用 `@PostMapping`
-```kotlin
+### Service
-// ✅ 正确
+- 可以使用 `suspend` 方法
@RestController
 class ExampleController(
    private val exampleService: ExampleService
 ) {
    @PostMapping("/example")
    fun getExample(): ResponseEntity<ApiResponse<ExampleDto>> {
        val data = runBlocking { exampleService.getData() }
        return ResponseEntity.ok(ApiResponse.success(data))
    }
 }
 // ❌ 错误
@RestController
 class ExampleController {
    @PostMapping("/example")
    suspend fun getExample(): ResponseEntity<ApiResponse<ExampleDto>> {  // 禁止使用suspend
        // ...
    }
 }
 ```
 ### Service规范
 - Service 层可以使用 `suspend` 方法
 - 使用 `@Transactional` 管理事务
 - 使用构造函数注入依赖
-```kotlin
+### Repository
-@Service
+- 继承 `JpaRepository<Entity, Long>`
 class ExampleService(
    private val exampleRepository: ExampleRepository
 ) {
    suspend fun getAllData(): List<ExampleEntity> {
        return exampleRepository.findAll()
    }
    @Transactional
    fun saveData(entity: ExampleEntity): ExampleEntity {
        return exampleRepository.save(entity)
    }
 }
 ```
 ### Repository规范
 - Repository 接口继承 `JpaRepository`
 - 使用 Spring Data JPA 方法命名规范
-```kotlin
+## API 接口规范
@Repository
 interface ExampleRepository : JpaRepository<ExampleEntity, Long> {
    fun findByCode(code: String): ExampleEntity?
    fun findByCategoryAndStatus(category: String, status: String): List<ExampleEntity>
    fun findByCategory(category: String): List<ExampleEntity>  // category: sports 或 crypto
 }
 ```
-### Entity规范
+### 统一响应格式
 - 使用 `@Entity` 和 `@Table` 注解
 - ID字段使用 `Long? = null`
 - 时间字段使用 `Long` 时间戳（毫秒）
 - 数值字段使用 `BigDecimal`，使用 `String` 存储
 ```kotlin
@Entity
@Table(name = "example_table")
 data class ExampleEntity(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    val id: Long? = null,
    @Column(name = "code", unique = true, nullable = false, length = 100)
    val code: String = "",
    @Column(name = "category", nullable = false, length = 20)
    val category: String = "",  // sports 或 crypto
    @Column(name = "amount", nullable = false, precision = 20, scale = 8)
    val amount: BigDecimal = BigDecimal.ZERO,
    @Column(name = "status", nullable = false, length = 20)
    val status: String = "",  // active, inactive
    @Column(name = "created_at", nullable = false)
    val createdAt: Long = System.currentTimeMillis(),
    @Column(name = "updated_at", nullable = false)
    var updatedAt: Long = System.currentTimeMillis()
 )
 ```
 ## 数值计算规范
 ### BigDecimal使用
 - 所有数值计算必须使用 `BigDecimal`
 - 使用 `String` 存储数值
 - 使用扩展函数进行安全转换和比较
 ```kotlin
 // 使用扩展函数
 val amount = "0.5".toSafeBigDecimal()
 val total = amount.add("0.4".toSafeBigDecimal())
 // 比较
 if (total.lt(BigDecimal.ONE)) {
    // 业务逻辑
 }
 ```
 ## 时间字段规范
 ### 时间戳使用
 - 所有时间字段使用 `Long` 类型存储毫秒级时间戳
 - **禁止**使用 `LocalDateTime` 或其他时间类型
 ```kotlin
 // ✅ 正确
@Column(name = "created_at", nullable = false)
 val createdAt: Long = System.currentTimeMillis()
 // ❌ 错误
@Column(name = "created_at")
 val createdAt: LocalDateTime = LocalDateTime.now()  // 禁止使用
 ```
 ## HTTP客户端规范
 ### Retrofit使用
 - 使用 Retrofit 定义 API 接口
 - 使用 OkHttp 作为底层 HTTP 客户端
 - 使用拦截器处理认证
 ```kotlin
 // Polymarket CLOB API接口定义（跟单系统需要）
 interface PolymarketClobApi {
    @POST("/orders")
    suspend fun createOrder(@Body order: CreateOrderRequest): Response<OrderResponse>
    @GET("/orders/active")
    suspend fun getActiveOrders(
        @Query("market") market: String?,
        @Query("limit") limit: Int?,
        @Query("offset") offset: Int?
    ): Response<List<OrderResponse>>
    @DELETE("/orders/{orderId}")
    suspend fun cancelOrder(@Path("orderId") orderId: String): Response<CancelOrderResponse>
    @GET("/trades")
    suspend fun getTrades(
        @Query("market") market: String?,
        @Query("user") user: String?,
        @Query("limit") limit: Int?,
        @Query("offset") offset: Int?
    ): Response<List<TradeResponse>>
 }
 // Retrofit配置
@Configuration
 class RetrofitConfig {
    @Bean
    fun polymarketClobApi(): PolymarketClobApi {
        val okHttpClient = OkHttpClient.Builder()
            .addInterceptor(AuthInterceptor())
            .build()
        return Retrofit.Builder()
            .baseUrl("https://clob.polymarket.com")
            .client(okHttpClient)
            .addConverterFactory(GsonConverterFactory.create())
            .build()
            .create(PolymarketClobApi::class.java)
    }
 }
 ```
 ## API接口规范
 ### 请求规范
 - **所有接口统一使用POST方法**，包括查询类接口
 - 请求头: `Content-Type: application/json`
 - 请求体: JSON格式
 ### 响应规范
 - **统一响应格式**:
 ```json
 {
  "code": 0,
@@ -398,77 +69,7 @@ class RetrofitConfig {
 }
 ```
- **响应字段说明**:
+### 错误码范围
  - `code`: 响应码，0表示成功，非0表示失败
  - `data`: 响应数据，可以是任意类型（对象、数组、字符串、数字等）
  - `msg`: 响应消息，成功时通常为空，失败时包含错误提示
 ### 响应示例
 **成功响应**:
 ```json
 {
  "code": 0,
  "data": {
    "id": "123",
    "name": "example"
  },
  "msg": ""
 }
 ```
 **失败响应**:
 ```json
 {
  "code": 1001,
  "data": null,
  "msg": "参数错误：参数不能为空"
 }
 ```
 ### Controller实现示例
 ```kotlin
@RestController
@RequestMapping("/api/example")
 class ExampleController(
    private val exampleService: ExampleService
 ) {
    private val logger = LoggerFactory.getLogger(ExampleController::class.java)
    @PostMapping("/list")
    fun getList(@RequestBody request: ExampleListRequest): ResponseEntity<ApiResponse<ExampleListResponse>> {
        return try {
            val data = runBlocking { exampleService.getList(request) }
            val response = ExampleListResponse(
                list = data,
                total = data.size.toLong(),
                page = request.page ?: 1,
                limit = request.limit ?: 20
            )
            ResponseEntity.ok(ApiResponse.success(response))
        } catch (e: Exception) {
            logger.error("Failed to get list", e)
            ResponseEntity.ok(ApiResponse.serverError("获取列表失败：${e.message}"))
        }
    }
 }
 // 统一响应格式
 data class ApiResponse<T>(
    val code: Int,
    val data: T?,
    val msg: String
 ) {
    companion object {
        fun <T> success(data: T): ApiResponse<T> = ApiResponse(0, data, "")
        fun <T> paramError(msg: String): ApiResponse<T> = ApiResponse(1001, null, msg)
        fun <T> serverError(msg: String): ApiResponse<T> = ApiResponse(5001, null, msg)
    }
 }
 ```
 ### 错误码规范
 - `0`: 成功
 - `1001-1999`: 参数错误
 - `2001-2999`: 认证/权限错误
@@ -476,7 +77,131 @@ data class ApiResponse<T>(
 - `4001-4999`: 业务逻辑错误
 - `5001-5999`: 服务器内部错误
-详细错误码定义参见需求文档
+### Controller 示例
 ```kotlin
@RestController
@RequestMapping("/api/example")
 class ExampleController(
    private val exampleService: ExampleService,
    private val messageSource: MessageSource
 ) {
    @PostMapping("/list")
    fun getList(@RequestBody request: ExampleListRequest): ResponseEntity<ApiResponse<ExampleListResponse>> {
        return try {
            val data = runBlocking { exampleService.getList(request) }
            ResponseEntity.ok(ApiResponse.success(data))
        } catch (e: Exception) {
            logger.error("Failed to get list", e)
            ResponseEntity.ok(ApiResponse.error(ErrorCode.SERVER_ERROR, messageSource))
        }
    }
 }
 ```
 ## 数值计算
 ```kotlin
 val amount = "0.5".toSafeBigDecimal()
 val total = amount.add("0.4".toSafeBigDecimal())
 if (total.lt(BigDecimal.ONE)) {
    // 业务逻辑
 }
 ```
 ## JSON 解析规范
 ### 使用扩展函数（推荐）
 - **优先**使用扩展函数 `fromJson<T>()` 和 `toJson()`，禁止直接使用 `Gson`
 - 扩展函数提供了类型安全的解析，使用方便
 ```kotlin
 // ✅ 正确：使用扩展函数（推荐）
 val json = "{\"name\":\"test\"}"
 val obj = json.fromJson<MyDataClass>()
 val jsonStr = obj.toJson()
 // ✅ 也可以：使用 JsonUtils 类（兼容旧代码）
 val obj = jsonUtils.fromJson<MyDataClass>(json)
 // ❌ 错误：直接使用 Gson
 val obj = gson.fromJson(json, MyDataClass::class.java)
 ```
 ### 扩展函数列表
 - `String?.fromJson<T>()` - 解析 JSON 字符串为对象（支持泛型）
 - `JsonElement?.fromJson<T>()` - 解析 JsonElement 为对象（支持泛型）
 - `Any?.toJson()` - 将对象转换为 JSON 字符串
 - `String?.parseStringArray()` - 解析 JSON 字符串数组
 ### JsonUtils 类
 - `JsonUtils` 主要用于初始化全局 Gson 实例，供扩展函数使用
 - 保留 `parseStringArray()` 方法用于兼容旧代码
 - 不推荐直接使用 `JsonUtils` 的方法，优先使用扩展函数
 ### Data Class 规范
 - **所有 data class 字段必须提供默认值**
 - 可空字段使用 `? = null`
 - 非空字段提供合适的默认值（空字符串、空集合、默认数值等）
 ```kotlin
 // ✅ 正确：所有字段都有默认值
 data class MyDto(
    val name: String = "",
    val age: Int = 0,
    val tags: List<String> = emptyList(),
    val optional: String? = null
 )
 // ❌ 错误：缺少默认值
 data class MyDto(
    val name: String,  // 缺少默认值
    val age: Int = 0
 )
 ```
 ## Side 判断规范
 **禁止**使用 "YES"/"NO" 字符串判断 side
 ```kotlin
 // ❌ 错误
 if (side != null && side.uppercase() == "NO") { }
 // ✅ 正确
 if (outcomeIndex != null && outcomeIndex == 1) { }
 ```
 ## 多语言规范
 - **禁止**硬编码中文或英文错误消息
 - **必须**使用 `ErrorCode` 枚举和 `MessageSource`
 ```kotlin
 // ❌ 错误
 return ResponseEntity.ok(ApiResponse.paramError("配置ID不能为空"))
 // ✅ 正确
 return ResponseEntity.ok(ApiResponse.error(ErrorCode.PARAM_EMPTY, messageSource))
 ```
 ### 多语言支持范围
 1. **API 响应消息**: 使用 `ErrorCode` + `MessageSource`
 2. **日志消息**: 可使用中文或英文
 3. **代码注释**: 建议使用中文
 4. **数据库字段**: 使用英文（snake_case）
 ## HTTP 客户端
 - 使用 Retrofit + OkHttp
 - 使用拦截器处理认证
 ## 跟单系统需求
 参考文档: `docs/copy-trading-requirements.md`
 核心功能:
 - 账户管理（私钥导入，多账户）
 - Leader 管理
 - 订单同步与执行
 - 跟单配置管理
 - 风险控制
 - 跟单记录与统计
 ## 禁止事项
@@ -484,173 +209,25 @@ data class ApiResponse<T>(
 - ❌ 禁止使用 `!!` 除非有明确原因
 - ❌ 禁止忽略异常
 - ❌ 禁止硬编码配置值
- ❌ 禁止提交敏感信息到Git
+- ❌ 禁止提交敏感信息到 Git
 - ❌ Controller 方法禁止使用 `suspend`
 - ❌ 实体类ID禁止使用 `Long = 0`
 - ❌ **禁止直接返回 mock 数据或硬编码的假数据**
 - ❌ **禁止在 API 调用失败时返回 mock 数据作为默认值**
 - ❌ **所有返回的数据必须来自真实的 API 调用或数据库查询**
 ### 配置
 - ❌ 禁止使用 `application.yml`
 - ❌ 禁止在代码中硬编码配置值
 ### 类型
 - ❌ 禁止使用 `Double` 进行数值计算
 - ❌ 禁止使用 `LocalDateTime` 存储时间
- ❌ 禁止实体类ID使用非空默认值
+- ❌ 禁止实体类 ID 使用非空默认值
 - ❌ 禁止直接使用 `Gson`（必须使用 `JsonUtils`）
 - ❌ 禁止 data class 字段缺少默认值
-### API接口
+### API 接口
- ❌ 禁止使用GET、PUT、DELETE等方法（统一使用POST）
+- ❌ 禁止使用 GET/PUT/DELETE（统一使用 POST）
 - ❌ 禁止返回不符合统一格式的响应
- ❌ 禁止在响应中直接返回Map类型（使用data class）
+- ❌ 禁止在响应中直接返回 Map 类型
-### Side 判断规范
+### Side 判断
- ❌ **禁止使用 "YES" 或 "NO" 字符串去判断 side**
+- ❌ 禁止使用 "YES"/"NO" 字符串判断 side
- ✅ **必须使用 `outcomeIndex` 来判断方向**（0 = 第一个 outcome，1 = 第二个 outcome，以此类推）
+- ✅ 必须使用 `outcomeIndex` 判断
 - ✅ 如果必须使用 side 字符串，应该从市场的 outcomes 数组中获取，而不是硬编码 "YES"/"NO"
 - ✅ 对于二元市场的价格转换，应该通过 `outcomeIndex` 判断是否为第二个 outcome（index = 1），而不是判断 side 是否为 "NO"
-```kotlin
+### 数据源
-// ❌ 错误：使用字符串比较判断 side
+- ❌ 禁止直接返回 mock 数据
-if (side != null && side.uppercase() == "NO") {
+- ❌ 禁止在 API 调用失败时返回 mock 数据
-    // 转换价格
+- ✅ 所有数据必须来自真实 API 或数据库查询
 }
 // ❌ 错误：硬编码 "YES"/"NO" 判断
 when (side.uppercase()) {
    "YES" -> // ...
    "NO" -> // ...
 }
 // ✅ 正确：使用 outcomeIndex 判断
 if (outcomeIndex != null && outcomeIndex == 1) {
    // 第二个 outcome（在二元市场中通常是 NO），转换价格
 }
 // ✅ 正确：从市场 outcomes 获取 side 信息
 val outcomes = JsonUtils.parseStringArray(market.outcomes)
 val targetOutcomeIndex = outcomes.indexOfFirst { it.equals(side, ignoreCase = true) }
 if (targetOutcomeIndex >= 0) {
    // 使用 targetOutcomeIndex 进行判断
 }
 ```
 ## 多语言使用规范
 ### 错误消息和响应文本
 - **禁止**在代码中硬编码中文或英文错误消息
 - **必须**使用 `ErrorCode` 枚举定义错误码和消息
 - **必须**使用 `ApiResponse.error(ErrorCode, messageSource)` 或 `MessageUtils.getMessage()` 获取国际化消息
 - **禁止**直接使用 `ApiResponse.paramError("硬编码消息")` 或 `ApiResponse.serverError("硬编码消息")`
 - 错误消息的默认语言使用中文（在 `ErrorCode` 枚举中定义），通过 `MessageSource` 支持多语言
 ### 使用 ErrorCode 和 MessageSource
 项目已经实现了国际化支持，必须使用以下方式：
 ```kotlin
 // ❌ 错误：硬编码错误消息
 return ResponseEntity.ok(ApiResponse.paramError("配置ID不能为空"))
 return ResponseEntity.ok(ApiResponse.serverError("获取配置列表失败：${e.message}"))
 // ✅ 正确：使用 ErrorCode 枚举
 return ResponseEntity.ok(ApiResponse.error(ErrorCode.PARAM_EMPTY, messageSource = messageSource))
 // ✅ 正确：使用 ErrorCode 和自定义消息（如果需要动态消息）
 return ResponseEntity.ok(ApiResponse.error(
    ErrorCode.PARAM_ERROR, 
    customMsg = "配置ID不能为空",
    messageSource = messageSource
 ))
 // ✅ 正确：使用 MessageUtils
@Autowired
 private lateinit var messageUtils: MessageUtils
 return ResponseEntity.ok(ApiResponse.error(
    ErrorCode.PARAM_EMPTY,
    messageSource = messageSource
 ))
 ```
 ### 添加新的错误码
 如果需要添加新的错误码，必须在 `ErrorCode` 枚举中定义：
 ```kotlin
 enum class ErrorCode(
    val code: Int,
    val message: String,  // 默认消息（中文）
    val messageKey: String  // 国际化消息键
 ) {
    // 新错误码示例
    NOTIFICATION_CONFIG_NOT_FOUND(3009, "通知配置不存在", "error.notification_config_not_found"),
    NOTIFICATION_CONFIG_INVALID(4009, "通知配置无效", "error.notification_config_invalid"),
 }
 ```
 然后在语言资源文件中添加对应的翻译：
 - `src/main/resources/messages_zh_CN.properties`
 - `src/main/resources/messages_zh_TW.properties`
 - `src/main/resources/messages_en.properties`
 ### 日志消息规范
 - **日志消息可以使用中文或英文**，便于开发调试
 - **禁止**在日志中硬编码用户可见的错误消息（应该使用 ErrorCode）
 - 日志消息应该清晰、简洁，便于排查问题
 - 日志中的业务数据（如账户名、订单ID等）可以使用原始值
 ### 代码注释规范
 - **代码注释可以使用中文或英文**
 - **业务逻辑注释**建议使用中文，便于团队理解
 - **API 文档注释**（KDoc）建议使用中文，但也可以使用英文
 - **类和方法注释**应该清晰说明功能和参数
 ### 数据库字段和配置
 - **数据库字段名**使用英文（snake_case）
 - **配置项名称**使用英文（kebab-case 或 dot.notation）
 - **枚举值**使用英文（UPPER_SNAKE_CASE）
 - **常量定义**使用英文（UPPER_SNAKE_CASE）
 ### 多语言支持策略
 1. **API 响应消息**：使用 `ErrorCode` 枚举，通过 `MessageSource` 支持多语言
 2. **错误码**：使用 `ErrorCode` 枚举，包含 `code`、`message`（默认中文）和 `messageKey`（国际化键）
 3. **日志消息**：可以使用中文或英文，便于开发调试
 4. **代码注释**：可以使用中文或英文，建议使用中文
 5. **业务数据**：根据实际需求，可以包含多语言内容（如市场标题、描述等）
 ### Controller 中使用多语言示例
 ```kotlin
@RestController
 class NotificationController(
    private val notificationConfigService: NotificationConfigService,
    private val messageSource: MessageSource  // 注入 MessageSource
 ) {
    @PostMapping("/configs/list")
    fun list(@RequestBody request: NotificationConfigListRequest): ResponseEntity<ApiResponse<List<NotificationConfigDto>>> {
        return try {
            // ... 业务逻辑
            ResponseEntity.ok(ApiResponse.success(configs))
        } catch (e: Exception) {
            logger.error("获取配置列表失败: ${e.message}", e)
            // ✅ 正确：使用 ErrorCode 和 MessageSource
            ResponseEntity.ok(ApiResponse.error(
                ErrorCode.SERVER_ERROR,
                messageSource = messageSource
            ))
        }
    }
    @PostMapping("/configs/detail")
    fun detail(@RequestBody request: NotificationConfigDetailRequest): ResponseEntity<ApiResponse<NotificationConfigDto>> {
        if (request.id == null) {
            // ✅ 正确：使用 ErrorCode
            return ResponseEntity.ok(ApiResponse.error(
                ErrorCode.PARAM_EMPTY,
                messageSource = messageSource
            ))
        }
        // ... 业务逻辑
    }
 }
 ```
@@ -5,107 +5,41 @@ path: frontend/**
 # 前端开发规范
-## 代码完成规范
+## 核心原则
-
+- **禁止**在代码中添加 TODO/FIXME/XXX 注释
-### TODO 处理规则
+- **禁止**使用 `any` 类型
- **禁止**在代码中添加 TODO 注释
+- **禁止**硬编码中文或英文文本
- **必须**根据 TODO 的内容直接完成代码实现
+- **必须**支持移动端和桌面端
 - 如果遇到暂时无法完全实现的功能，应该：
  1. 实现一个可用的基础版本
  2. 添加清晰的注释说明当前实现的限制和后续改进方向
  3. 确保代码可以正常编译和运行
 - **禁止**使用 `// TODO: 实现XXX` 这样的注释
 - **禁止**使用 `// FIXME:` 或 `// XXX:` 这样的注释
 - 如果某个功能需要依赖外部资源（如 API、库等），应该：
  1. 先实现一个占位或模拟实现
  2. 在注释中说明依赖关系和实现方式
  3. 确保代码逻辑完整，不会因为未实现的功能而崩溃
 ### API 调用实现规则
 - **必须**查找相关的 API 文档或接口定义
 - **必须**根据 API 文档完成代码实现
 - **禁止**在 API 调用处添加 TODO 注释
 - 如果 API 文档不完整，应该：
  1. 查找项目中已有的类似 API 调用作为参考
  2. 查看 API 服务定义（如 `services/api.ts`）
  3. 查看 API 文档（如 `docs/copy-trading-requirements.md`）
  4. 实现一个可用的版本，包含错误处理
 ### 代码完成示例
 ```typescript
 // ❌ 错误：添加 TODO 注释
 const fetchAccountBalance = async (accountId: number) => {
  // TODO: 调用 API 查询余额
  return { balance: '0' }
 }
 // ✅ 正确：查找 API 定义并完成实现
 // 1. 查找 API 服务定义：services/api.ts 中的 accounts.balance
 // 2. 查找 API 文档：docs/copy-trading-requirements.md
 // 3. 实现完整的 API 调用逻辑
 const fetchAccountBalance = async (accountId: number) => {
  try {
    // 根据 API 服务定义调用接口
    const response = await apiService.accounts.balance({ accountId })
    // 根据 API 响应格式处理数据
    if (response.data.code === 0 && response.data.data) {
      return response.data.data
    } else {
      // API 调用失败时返回默认值
      console.warn('查询余额失败，返回默认值:', response.data.msg)
      return { balance: '0' }
    }
  } catch (error) {
    console.error('查询余额异常:', error)
    // 异常时返回默认值，确保代码可以正常运行
    return { balance: '0' }
  }
 }
 ```
 ## 技术栈
 - **框架**: React + TypeScript
- **UI库**: Ant Design 或 Material-UI（推荐 Ant Design Mobile 用于移动端）
+- **UI 库**: Ant Design（移动端使用 Ant Design Mobile）
- **HTTP客户端**: axios
+- **HTTP 客户端**: axios
- **状态管理**: Zustand 或 Redux
+- **状态管理**: Zustand
- **响应式设计**: 必须支持移动端和桌面端
+- **国际化**: react-i18next
-## 移动端适配要求
+## 移动端适配
-### 响应式设计
+### 响应式断点
 - **必须支持移动端和桌面端**
 - 使用响应式布局（Responsive Design）
 - 移动端优先（Mobile First）设计原则
 - 支持触摸操作和手势
 ### 断点设置
 - **移动端**: < 768px
 - **平板**: 768px - 1024px
 - **桌面端**: > 1024px
-### UI 组件适配
+### 适配要求
- 使用 Ant Design 的响应式组件
+- 使用响应式布局（Mobile First）
- 移动端使用 Ant Design Mobile（如果使用 Ant Design）
+- 导航栏：移动端抽屉菜单，桌面端顶部导航
- 表格使用虚拟滚动或分页（移动端性能优化）
+- 列表：移动端卡片布局，桌面端表格布局
- 表单使用移动端友好的输入组件
+- 按钮：移动端不小于 44x44px
-
+- 支持触摸操作和手势
 ### 布局适配
 - 导航栏：移动端使用抽屉菜单，桌面端使用顶部导航
 - 列表：移动端使用卡片布局，桌面端使用表格布局
 - 按钮：移动端按钮尺寸不小于 44x44px（触摸友好）
 - 间距：移动端使用更大的间距，提高可点击区域
 ### 性能优化
 - 图片懒加载
 - 代码分割（Code Splitting）
 - 移动端减少动画效果
 - 使用 CSS 媒体查询优化样式
 ## 代码规范
-### 组件规范
+### 组件
 - 使用函数式组件
 - 使用 TypeScript 类型定义
 - 组件文件使用 PascalCase 命名
@@ -122,24 +56,18 @@ export const MarketCard: React.FC<MarketProps> = ({ marketId, platform }) => {
 };
 // ❌ 错误
-export const marketCard = (props: any) => {  // 禁止使用any
+export const marketCard = (props: any) => { }
  // ...
 };
 ```
-### API调用规范
+### API 调用
- 使用 axios 进行 HTTP 请求
+- 使用 axios
 - 统一错误处理
 - 使用 TypeScript 定义响应类型
 ```typescript
 // API服务
 import axios from 'axios';
 interface Market {
  id: string;
  marketId: string;
  platform: string;
  title: string;
 }
@@ -147,24 +75,16 @@ export const marketService = {
  getMarkets: async (): Promise<Market[]> => {
    const response = await axios.get<Market[]>('/api/markets');
    return response.data;
  },
  getMarketById: async (id: string): Promise<Market> => {
    const response = await axios.get<Market>(`/api/markets/${id}`);
    return response.data;
  }
 };
 ```
-### 状态管理规范
+### 状态管理
- 使用 Zustand 或 Redux 管理全局状态
+- 全局状态使用 Zustand
 - 本地状态使用 `useState`
 - 复杂状态使用 `useReducer`
 ```typescript
 // Zustand Store示例
 import { create } from 'zustand';
 interface MarketStore {
  markets: Market[];
  setMarkets: (markets: Market[]) => void;
@@ -176,80 +96,64 @@ export const useMarketStore = create<MarketStore>((set) => ({
 }));
 ```
-### USDC 金额格式化规范
+### USDC 金额格式化
- **必须**使用 `formatUSDC` 函数格式化所有 USDC 金额显示
+**必须**使用 `formatUSDC` 函数（从 `../utils` 导入）
 - **禁止**直接使用 `toFixed()` 或 `parseFloat().toFixed()` 格式化 USDC
 - **禁止**硬编码小数位数格式化 USDC
 - 所有 USDC 金额显示必须统一使用 `formatUSDC` 函数
 #### formatUSDC 函数说明
 - **位置**: `src/utils/index.ts`
 - **功能**: 格式化 USDC 金额，最多显示 4 位小数，自动去除尾随零（截断，不四舍五入）
 - **参数**: `value: string | number | undefined | null`
 - **返回值**: 格式化后的字符串，如果值为空或无效则返回 `'-'`
 #### 使用示例
 ```typescript
 // ✅ 正确：使用 formatUSDC 格式化 USDC 金额
 import { formatUSDC } from '../utils'
-const BalanceDisplay: React.FC<{ balance: string }> = ({ balance }) => {
+// ✅ 正确
  return <span>{formatUSDC(balance)} USDC</span>
 }
 // ✅ 正确：在表格列中使用
 const columns = [
  {
    title: '余额',
    dataIndex: 'balance',
    render: (balance: string) => `${formatUSDC(balance)} USDC`
  }
 ]
 // ✅ 正确：在统计组件中使用
 <Statistic
  title="总盈亏"
  value={formatUSDC(stats?.totalPnl || '0')}
  suffix="USDC"
 />
-// ❌ 错误：直接使用 toFixed
+// ❌ 错误
-const balance = parseFloat(value).toFixed(4)  // 禁止
+const balance = parseFloat(value).toFixed(4)
 // ❌ 错误：硬编码格式化
 const balance = `${parseFloat(value).toFixed(2)} USDC`  // 禁止
 // ❌ 错误：使用自定义格式化函数
 const formatBalance = (value: string) => parseFloat(value).toFixed(4)  // 禁止
 ```
-#### 格式化规则
+**格式化规则**:
- **最多显示 4 位小数**：如果金额超过 4 位小数，截断到 4 位（不四舍五入）
+- 最多显示 4 位小数（截断，不四舍五入）
- **自动去除尾随零**：去除不必要的尾随零和小数点
+- 自动去除尾随零
- **示例**：
+- 空值返回 `'-'`
  - `formatUSDC(1.23)` => `"1.23"`
  - `formatUSDC(1.23456)` => `"1.2345"`（截断，不四舍五入）
  - `formatUSDC(1.2)` => `"1.2"`
  - `formatUSDC(1)` => `"1"`
  - `formatUSDC(1.23459)` => `"1.2345"`（截断，不四舍五入）
  - `formatUSDC(null)` => `"-"`
  - `formatUSDC(undefined)` => `"-"`
-#### 工具函数统一导出
+## 多语言规范
- 所有工具函数统一从 `src/utils/index.ts` 导出
+
- **必须**从 `../utils` 导入工具函数，而不是从具体文件导入
+### 使用方式
- `ethers.ts` 中的函数也会在 `index.ts` 中统一导出
+**必须**使用 `useTranslation` Hook
 ```typescript
-// ✅ 正确：从 utils 统一导入
+// ✅ 正确
-import { formatUSDC, getAddressFromPrivateKey, isValidWalletAddress } from '../utils'
+import { useTranslation } from 'react-i18next'
-// ❌ 错误：从具体文件导入
+const MyComponent: React.FC = () => {
-import { formatUSDC } from '../utils/index'
+  const { t } = useTranslation()
-import { getAddressFromPrivateKey } from '../utils/ethers'
+  
  return (
    <div>
      <h1>{t('page.title')}</h1>
      <Button>{t('common.save')}</Button>
    </div>
  )
 }
 // ❌ 错误：硬编码文本
 <h1>页面标题</h1>
 <Button>保存</Button>
 ```
 ### 语言文件
 - 位置: `src/locales/{locale}/common.json`
 - 支持: `zh-CN`、`zh-TW`、`en`
 - 键名: 点号分隔的层级结构（如 `notificationSettings.title`）
 ### 添加新翻译
 1. 在 `src/locales/zh-CN/common.json` 添加中文
 2. 在 `src/locales/zh-TW/common.json` 添加繁体
 3. 在 `src/locales/en/common.json` 添加英文
 4. 在组件中使用 `t('key')`
 ## 移动端适配示例
 ### 响应式布局
@@ -267,29 +171,6 @@ const MyComponent: React.FC = () => {
 };
 ```
 ### 移动端导航
 ```typescript
 import { Drawer } from 'antd';
 const MobileNav: React.FC = () => {
  const [open, setOpen] = useState(false);
  return (
    <>
      <Button onClick={() => setOpen(true)}>菜单</Button>
      <Drawer
        title="导航"
        placement="left"
        onClose={() => setOpen(false)}
        open={open}
      >
        {/* 导航内容 */}
      </Drawer>
    </>
  );
 };
 ```
 ### 响应式表格
 ```typescript
 import { Table } from 'antd';
@@ -316,63 +197,18 @@ const ResponsiveTable: React.FC = () => {
 ### 代码质量
 - ❌ 禁止使用 `any` 类型
 - ❌ 禁止忽略错误处理
- ❌ 禁止硬编码API地址
+- ❌ 禁止硬编码 API 地址
 - ❌ 禁止在组件中直接使用 `fetch`
 - ❌ 禁止忽略移动端适配
 ### 类型安全
 - ❌ 禁止使用 `any`
 - ❌ 禁止忽略 TypeScript 类型检查
 - ❌ 禁止使用 `@ts-ignore` 除非有明确原因
 ### 移动端适配
 - ❌ 禁止固定宽度布局
 - ❌ 禁止使用过小的触摸目标（< 44x44px）
- ❌ 禁止忽略移动端性能优化
+- ❌ 禁止使用桌面端专用交互（如 hover）
 - ❌ 禁止使用桌面端专用的交互方式（如 hover）
-### 多语言使用规范
+### 多语言
- **必须**使用多语言（i18n）进行所有文本显示
+- ❌ 禁止硬编码中文或英文文本
- **禁止**在组件中硬编码中文或英文文本
+- ❌ 禁止绕过 `useTranslation` 直接显示文本
 - **必须**使用 `useTranslation` Hook 获取翻译函数
 - **必须**在语言文件中定义所有显示的文本
 - **必须**支持至少中文（简体/繁体）和英文
 #### 多语言使用示例
 ```typescript
 // ✅ 正确：使用多语言
 import { useTranslation } from 'react-i18next'
 const MyComponent: React.FC = () => {
  const { t } = useTranslation()
  return (
    <div>
      <h1>{t('page.title')}</h1>
      <Button>{t('common.save')}</Button>
    </div>
  )
 }
 // ❌ 错误：硬编码文本
 const MyComponent: React.FC = () => {
  return (
    <div>
      <h1>页面标题</h1>  {/* 禁止硬编码 */}
      <Button>保存</Button>  {/* 禁止硬编码 */}
    </div>
  )
 }
 ```
 #### 语言文件结构
 - 语言文件位置：`src/locales/{locale}/common.json`
 - 支持的语言：`zh-CN`（简体中文）、`zh-TW`（繁体中文）、`en`（英文）
 - 键名使用点号分隔的层级结构，如：`notificationSettings.title`
 #### 添加新翻译的步骤
 1. 在 `src/locales/zh-CN/common.json` 中添加中文翻译
 2. 在 `src/locales/zh-TW/common.json` 中添加繁体中文翻译
 3. 在 `src/locales/en/common.json` 中添加英文翻译
 4. 在组件中使用 `t('key')` 获取翻译
@@ -14,11 +14,11 @@
 .DS_Store
 # 构建产物
-backend/build/
+# 注意：frontend/dist 和 backend/build/libs 在使用 BUILD_IN_DOCKER=false 时是必需的
 # 所以不能忽略它们。在 BUILD_IN_DOCKER=true 时，它们会被 Docker 内部编译覆盖
 backend/.gradle/
 backend/out/
 backend/bin/
 frontend/dist/
 frontend/node_modules/
 frontend/.vite/
 frontend/.cache/
@@ -9,13 +9,16 @@ jobs:
  build-and-push:
    runs-on: ubuntu-latest
    permissions:
      contents: write  # 需要写权限以上传 Assets
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          ref: ${{ github.event.release.tag_name }}  # 使用 release 对应的 tag
-      - name: Extract version from release
+      - name: Extract version and check if pre-release
        id: extract_version
        run: |
          # 从 release tag 中提取版本号（例如 v1.0.0 -> 1.0.0）
@@ -31,10 +34,159 @@ jobs:
          fi
          VERSION=${TAG_NAME#v}  # 移除 v 前缀
          IS_PRERELEASE="${{ github.event.release.prerelease }}"
          echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
          echo "TAG=$TAG_NAME" >> $GITHUB_OUTPUT
-          echo "Extracted version: $VERSION"
+          echo "IS_PRERELEASE=$IS_PRERELEASE" >> $GITHUB_OUTPUT
-          echo "Full tag: $TAG_NAME"
+          
          if [ "$IS_PRERELEASE" = "true" ]; then
            echo "📋 这是 Pre-release: $TAG_NAME"
          else
            echo "📦 这是正式版本: $TAG_NAME"
          fi
      - name: Send Telegram notification (build started)
        if: steps.extract_version.outputs.IS_PRERELEASE == 'false'
        env:
          TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
          TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}
        run: |
          # 检查必要的环境变量
          if [ -z "$TELEGRAM_BOT_TOKEN" ] || [ -z "$TELEGRAM_CHAT_ID" ]; then
            echo "⚠️  Telegram Bot Token 或 Chat ID 未配置，跳过通知"
            exit 0
          fi
          # 获取构建信息
          VERSION="${{ steps.extract_version.outputs.VERSION }}"
          TAG="${{ steps.extract_version.outputs.TAG }}"
          RELEASE_URL="${{ github.event.release.html_url }}"
          # 构建消息内容（仅包含关键信息）
          MESSAGE="🔨 <b>Docker 镜像构建中</b>"$'\n'$'\n'"📦 <b>版本:</b> ${VERSION}"$'\n'"🏷️ <b>Tag:</b> <code>${TAG}</code>"$'\n'"🔗 <a href=\"${RELEASE_URL}\">查看 Release</a>"
          # 发送 Telegram 消息（使用 jq 转义 JSON）
          curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
            -H "Content-Type: application/json" \
            -d "$(jq -n \
              --arg chat_id "$TELEGRAM_CHAT_ID" \
              --arg text "$MESSAGE" \
              '{chat_id: $chat_id, text: $text, parse_mode: "HTML", disable_web_page_preview: false}')" > /tmp/telegram_response.json
          # 检查发送结果
          if [ $? -eq 0 ]; then
            RESPONSE=$(cat /tmp/telegram_response.json)
            if echo "$RESPONSE" | grep -q '"ok":true'; then
              echo "✅ Telegram 通知发送成功"
            else
              echo "❌ Telegram 通知发送失败: $RESPONSE"
              # 通知失败不应该导致整个 job 失败
              exit 0
            fi
          else
            echo "❌ 发送 Telegram 消息时发生错误"
            # 通知失败不应该导致整个 job 失败
            exit 0
          fi
      # ============ 编译前后端产物 ============
      - name: Setup JDK 17
        uses: actions/setup-java@v4
        with:
          java-version: '17'
          distribution: 'temurin'
      - name: Build Backend JAR
        run: |
          cd backend
          chmod +x gradlew
          ./gradlew bootJar --no-daemon
          echo "✅ 后端构建完成"
          ls -lh build/libs/*.jar
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '18'
      - name: Build Frontend
        env:
          VERSION: ${{ steps.extract_version.outputs.VERSION }}
          GIT_TAG: ${{ steps.extract_version.outputs.TAG }}
          GITHUB_REPO_URL: https://github.com/WrBug/PolyHermes
        run: |
          cd frontend
          npm ci
          npm run build
          echo "✅ 前端构建完成"
          echo "📦 版本信息: VERSION=${{ steps.extract_version.outputs.VERSION }}, GIT_TAG=${{ steps.extract_version.outputs.TAG }}"
          du -sh dist/
      # ============ 打包更新包 ============
      - name: Create Update Package
        run: |
          echo "📦 开始打包更新包..."
          # 创建目录结构
          mkdir -p update-package/backend
          mkdir -p update-package/frontend
          # 复制后端 JAR
          cp backend/build/libs/*.jar update-package/backend/polyhermes.jar
          echo "✅ 后端 JAR 已复制"
          # 复制前端产物
          cp -r frontend/dist/* update-package/frontend/
          echo "✅ 前端文件已复制"
          # 创建版本信息文件
          cat > update-package/version.json <<EOF
          {
            "version": "${{ steps.extract_version.outputs.VERSION }}",
            "tag": "${{ steps.extract_version.outputs.TAG }}",
            "buildTime": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
            "releaseNotes": $(echo '${{ github.event.release.body }}' | jq -Rs .)
          }
          EOF
          echo "✅ 版本信息已创建"
          # 打包成 tar.gz
          cd update-package
          tar -czf ../polyhermes-${{ steps.extract_version.outputs.TAG }}-update.tar.gz .
          cd ..
          echo "✅ 打包完成: polyhermes-${{ steps.extract_version.outputs.TAG }}-update.tar.gz"
          ls -lh polyhermes-*.tar.gz
      - name: Calculate Checksum
        id: checksum
        run: |
          FILE="polyhermes-${{ steps.extract_version.outputs.TAG }}-update.tar.gz"
          CHECKSUM=$(sha256sum "$FILE" | awk '{print $1}')
          echo "CHECKSUM=$CHECKSUM" >> $GITHUB_OUTPUT
          echo "✅ SHA256: $CHECKSUM"
          echo "$CHECKSUM  $FILE" > checksums.txt
      - name: Upload Update Package to Release
        uses: actions/upload-release-asset@v1
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          upload_url: ${{ github.event.release.upload_url }}
          asset_path: ./polyhermes-${{ steps.extract_version.outputs.TAG }}-update.tar.gz
          asset_name: polyhermes-${{ steps.extract_version.outputs.TAG }}-update.tar.gz
          asset_content_type: application/gzip
      - name: Upload Checksums
        uses: actions/upload-release-asset@v1
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          upload_url: ${{ github.event.release.upload_url }}
          asset_path: ./checksums.txt
          asset_name: checksums.txt
          asset_content_type: text/plain
      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3
@@ -48,6 +200,22 @@ jobs:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}
      - name: Prepare Docker build context
        run: |
          echo "📦 准备 Docker 构建上下文..."
          # 确保构建产物存在且可访问
          if [ ! -d "frontend/dist" ]; then
            echo "❌ 错误：frontend/dist 不存在"
            exit 1
          fi
          if [ ! -d "backend/build/libs" ] || [ -z "$(ls -A backend/build/libs/*.jar 2>/dev/null)" ]; then
            echo "❌ 错误：backend/build/libs/*.jar 不存在"
            exit 1
          fi
          echo "✅ 构建产物已准备好"
          ls -lh frontend/dist/ | head -5
          ls -lh backend/build/libs/*.jar
      - name: Build and push Docker image
        uses: docker/build-push-action@v5
        with:
@@ -58,10 +226,58 @@ jobs:
          platforms: linux/amd64,linux/arm64
          tags: |
            wrbug/polyhermes:${{ steps.extract_version.outputs.TAG }}
-            wrbug/polyhermes:latest
+            ${{ steps.extract_version.outputs.IS_PRERELEASE == 'false' && 'wrbug/polyhermes:latest' || '' }}
          build-args: |
            BUILD_IN_DOCKER=false
            VERSION=${{ steps.extract_version.outputs.VERSION }}
            GIT_TAG=${{ steps.extract_version.outputs.TAG }}
            GITHUB_REPO_URL=https://github.com/WrBug/PolyHermes
          cache-from: type=registry,ref=wrbug/polyhermes:latest
          cache-to: type=inline
      - name: Send Telegram notification
        if: steps.extract_version.outputs.IS_PRERELEASE == 'false'
        env:
          TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
          TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}
        run: |
          # 检查必要的环境变量
          if [ -z "$TELEGRAM_BOT_TOKEN" ] || [ -z "$TELEGRAM_CHAT_ID" ]; then
            echo "⚠️  Telegram Bot Token 或 Chat ID 未配置，跳过通知"
            exit 0
          fi
          # 获取构建信息
          VERSION="${{ steps.extract_version.outputs.VERSION }}"
          TAG="${{ steps.extract_version.outputs.TAG }}"
          RELEASE_NAME="${{ github.event.release.name }}"
          RELEASE_URL="${{ github.event.release.html_url }}"
          REPO_NAME="${{ github.repository }}"
          # 构建消息内容（仅包含关键信息）
          DEPLOY_DOC_URL="https://github.com/WrBug/PolyHermes/blob/main/docs/zh/DEPLOYMENT.md"
          MESSAGE="✅ <b>Docker 镜像构建成功</b>"$'\n'$'\n'"📦 <b>版本:</b> ${VERSION}"$'\n'"🏷️ <b>Tag:</b> <code>${TAG}</code>"$'\n'"🔗 <a href=\"${RELEASE_URL}\">查看 Release</a>"$'\n'"📚 <a href=\"${DEPLOY_DOC_URL}\">Docker 部署文档</a>"
          # 发送 Telegram 消息（使用 jq 转义 JSON）
          curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
            -H "Content-Type: application/json" \
            -d "$(jq -n \
              --arg chat_id "$TELEGRAM_CHAT_ID" \
              --arg text "$MESSAGE" \
              '{chat_id: $chat_id, text: $text, parse_mode: "HTML", disable_web_page_preview: false}')" > /tmp/telegram_response.json
          # 检查发送结果
          if [ $? -eq 0 ]; then
            RESPONSE=$(cat /tmp/telegram_response.json)
            if echo "$RESPONSE" | grep -q '"ok":true'; then
              echo "✅ Telegram 通知发送成功"
            else
              echo "❌ Telegram 通知发送失败: $RESPONSE"
              # 构建成功，通知失败不应该导致整个 job 失败
              exit 0
            fi
          else
            echo "❌ 发送 Telegram 消息时发生错误"
            # 构建成功，通知失败不应该导致整个 job 失败
            exit 0
          fi
@@ -0,0 +1,103 @@
 name: Telegram Notification on PR Merge
 on:
  pull_request:
    types:
      - closed  # 当 PR 被关闭（合并或关闭）时触发
 jobs:
  notify:
    runs-on: ubuntu-latest
    # 只在 PR 被合并到 main 分支时执行
    if: github.event.pull_request.merged == true && github.event.pull_request.base.ref == 'main'
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Get PR details
        id: pr_details
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          PR_NUMBER="${{ github.event.pull_request.number }}"
          REPO="${{ github.repository }}"
          # 获取 PR 详细信息
          PR_RESPONSE=$(curl -s -H "Authorization: token ${GITHUB_TOKEN}" \
            -H "Accept: application/vnd.github.v3+json" \
            "https://api.github.com/repos/${REPO}/pulls/${PR_NUMBER}")
          # 获取 PR 变更的文件列表
          FILES_RESPONSE=$(curl -s -H "Authorization: token ${GITHUB_TOKEN}" \
            -H "Accept: application/vnd.github.v3+json" \
            "https://api.github.com/repos/${REPO}/pulls/${PR_NUMBER}/files")
          # 提取 PR 描述（body），保留换行，限制长度
          PR_BODY=$(echo "$PR_RESPONSE" | jq -r '.body // ""')
          if [ ${#PR_BODY} -gt 500 ]; then
            PR_BODY="${PR_BODY:0:500}..."
          fi
          # 保存到输出变量（使用 base64 编码避免特殊字符问题）
          echo "pr_body<<EOF" >> $GITHUB_OUTPUT
          echo "$PR_BODY" >> $GITHUB_OUTPUT
          echo "EOF" >> $GITHUB_OUTPUT
      - name: Send Telegram notification
        env:
          TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
          TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}
        run: |
          # 检查 PR 是否被合并（而不是仅关闭）
          PR_MERGED="${{ github.event.pull_request.merged }}"
          if [ "$PR_MERGED" != "true" ]; then
            echo "ℹ️  PR 仅关闭，未合并，跳过通知"
            exit 0
          fi
          # 检查必要的环境变量
          # 注意：TELEGRAM_CHAT_ID 可以是个人聊天 ID（正数）或群组 ID（负数，如 -1001234567890）
          if [ -z "$TELEGRAM_BOT_TOKEN" ] || [ -z "$TELEGRAM_CHAT_ID" ]; then
            echo "⚠️  Telegram Bot Token 或 Chat ID 未配置，跳过通知"
            exit 0
          fi
          # 获取 PR 基本信息
          PR_NUMBER="${{ github.event.pull_request.number }}"
          PR_TITLE="${{ github.event.pull_request.title }}"
          PR_URL="${{ github.event.pull_request.html_url }}"
          PR_MERGE_COMMIT="${{ github.event.pull_request.merge_commit_sha }}"
          # 获取 PR 详细信息
          PR_BODY="${{ steps.pr_details.outputs.pr_body }}"
          # 转义 PR 标题中的 HTML 特殊字符
          PR_TITLE_ESCAPED=$(echo "$PR_TITLE" | sed 's/&/\&amp;/g' | sed 's/</\&lt;/g' | sed 's/>/\&gt;/g')
          # 构建消息内容（仅包含关键信息）
          MESSAGE="🚀 <b>main 分支代码更新</b>"$'\n'$'\n'"📝 <b>PR #${PR_NUMBER}:</b> ${PR_TITLE_ESCAPED}"$'\n'"🔗 <a href=\"${PR_URL}\">查看 PR</a>"
          # 发送 Telegram 消息（使用 jq 转义 JSON）
          curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
            -H "Content-Type: application/json" \
            -d "$(jq -n \
              --arg chat_id "$TELEGRAM_CHAT_ID" \
              --arg text "$MESSAGE" \
              '{chat_id: $chat_id, text: $text, parse_mode: "HTML", disable_web_page_preview: false}')" > /tmp/telegram_response.json
          # 检查发送结果
          if [ $? -eq 0 ]; then
            RESPONSE=$(cat /tmp/telegram_response.json)
            if echo "$RESPONSE" | grep -q '"ok":true'; then
              echo "✅ Telegram 通知发送成功"
            else
              echo "❌ Telegram 通知发送失败: $RESPONSE"
              exit 1
            fi
          else
            echo "❌ 发送 Telegram 消息时发生错误"
            exit 1
          fi
@@ -17,7 +17,8 @@ backend/out/
 backend/*.log
 backend/gradle-app.setting
 backend/.gradle
-backend/gradle-wrapper.jar
+# 注意：gradle-wrapper.jar 应该被提交，不要忽略
 # backend/gradle/wrapper/gradle-wrapper.jar
 # Kotlin
 *.kt.bak
@@ -25,6 +26,7 @@ backend/gradle-wrapper.jar
 # Java
 *.jar
 !backend/gradle/wrapper/gradle-wrapper.jar  # Gradle Wrapper JAR 应该被提交
 *.war
 *.ear
 *.class
@@ -94,6 +96,13 @@ coverage/
 test-results/
 *.test.log
 # Python
 __pycache__/
 *.py[cod]
 *$py.class
 *.so
 .Python
 # Misc
 *.bak
 *.backup
@@ -102,4 +111,5 @@ test-results/
 # Submodules and external dependencies
 clob-client/
 builder-relayer-client/
 landing-page/
@@ -0,0 +1,37 @@
 # PolyHermes 动态更新功能 - 遗漏检查与修复报告
 ## 检查时间
 2026-01-21 03:00
 ## ✅ 已发现并修复的遗漏
 ### 1. docker-compose.prod.yml 环境变量
 - **问题**: 生产环境部署文件缺少 `ALLOW_PRERELEASE` 和 `GITHUB_REPO`。
 - **修复**: 已添加到 `docker-compose.prod.yml`。
 ### 2. 后端权限验证端点
 - **问题**: `/api/auth/verify` 端点缺失，导致 Python 更新服务无法验证管理员权限。
 - **修复**: 已在 `AuthController` 中添加 `/verify` 接口，仅允许 ADMIN 角色访问。
 ### 3. README.md 文档
 - **问题**: 未提及新功能。
 - **修复**: 已在 README 中添加"动态更新"功能说明及文档链接。
 ### 4. Docker Python 依赖优化
 - **问题**: 使用 `pip install` 可能导致依赖冲突或安装缓慢。
 - **修复**: 替换为 `apt-get install python3-flask python3-requests`，使用系统包更稳定、快速，且减小镜像体积。
 ---
 ## 🏁 最终状态
 所有已知的遗漏都已检查并修复。系统现已准备好进行集成测试。
 ### 建议测试步骤
 1. **本地构建测试**: `./deploy.sh` 验证 Dockerfile 更改（系统包安装）。
 2. **后端测试**: 验证 `/api/auth/verify` 接口（需登录并在 Header 带上 Token）。
 3. **流程测试**: 按计划进行 Pre-release 测试。
 ---
 **状态**: ✅ **全功能就绪，已加固**
@@ -1,6 +1,12 @@
-# 多阶段构建：前后端一体化部署
+# 多阶段构建：前后端一体化部署（支持混合编译）
-# 阶段1：构建前端
+# 构建参数：控制是否在 Docker 内编译
 # - BUILD_IN_DOCKER=true  (默认): Docker 内部编译（本地开发）
 # - BUILD_IN_DOCKER=false: 使用外部产物（GitHub Actions）
 ARG BUILD_IN_DOCKER=true
 # ==================== 阶段1：构建前端 ====================
 FROM node:18-alpine AS frontend-build
 ARG BUILD_IN_DOCKER
 WORKDIR /app/frontend
@@ -13,19 +19,36 @@ ARG GITHUB_REPO_URL=https://github.com/WrBug/PolyHermes
 ENV VERSION=${VERSION}
 ENV GIT_TAG=${GIT_TAG}
 ENV GITHUB_REPO_URL=${GITHUB_REPO_URL}
-
+# 复制前端文件（先复制 package.json 以利用 Docker 缓存）
 # 复制前端文件
 COPY frontend/package*.json ./
 RUN npm ci
 # 条件：仅在 Docker 内部编译时安装依赖
 RUN if [ "$BUILD_IN_DOCKER" = "true" ]; then \
      npm ci; \
    fi
 # 复制所有前端源文件
 COPY frontend/ ./
-# 构建前端（使用相对路径，通过 Nginx 代理）
+# 条件：仅在 Docker 内部编译时执行构建
-# 版本号会通过环境变量注入到构建产物中
+# 如果 BUILD_IN_DOCKER=false，需要从构建上下文复制外部编译的 dist
-RUN npm run build
+RUN if [ "$BUILD_IN_DOCKER" = "true" ]; then \
      echo "🔨 Docker 内部编译前端..."; \
      npm run build; \
    else \
      echo "⏭️  使用外部产物，将在下一步复制"; \
      mkdir -p dist; \
    fi
-# 阶段2：构建后端
+# 如果使用外部产物，从构建上下文复制外部编译的 dist
 # 注意：这个 COPY 在 BUILD_IN_DOCKER=false 时必需
 # 在 BUILD_IN_DOCKER=true 时，如果前端已编译，这个 COPY 会尝试覆盖，但结果相同
 # 如果本地没有 dist（BUILD_IN_DOCKER=true 且未编译），这个 COPY 会失败，但上面的 RUN 已经编译了
 COPY frontend/dist ./dist
 # ==================== 阶段2：构建后端 ====================
 FROM gradle:8.5-jdk17 AS backend-build
 ARG BUILD_IN_DOCKER
 WORKDIR /app/backend
@@ -33,60 +56,75 @@ WORKDIR /app/backend
 COPY backend/build.gradle.kts backend/settings.gradle.kts ./
 COPY backend/gradle ./gradle
-# 下载依赖（利用 Docker 缓存）
+# 条件：仅在 Docker 内部编译时下载依赖
-RUN gradle dependencies --no-daemon || true
+RUN if [ "$BUILD_IN_DOCKER" = "true" ]; then \
      gradle dependencies --no-daemon || true; \
    fi
 # 复制源代码
 COPY backend/src ./src
-# 构建应用
+# 如果使用外部产物，先从构建上下文复制外部编译的 JAR
-RUN gradle bootJar --no-daemon
+# 注意：如果 BUILD_IN_DOCKER=true 且本地没有 JAR，这个 COPY 会失败，但会在下面编译生成
 COPY backend/build/libs/*.jar build/libs/
-# 阶段3：运行环境
+# 条件：仅在 Docker 内部编译时执行构建（会覆盖外部产物）
 RUN if [ "$BUILD_IN_DOCKER" = "true" ]; then \
      echo "🔨 Docker 内部编译后端..."; \
      gradle bootJar --no-daemon; \
    else \
      echo "⏭️  使用外部产物"; \
      mkdir -p build/libs; \
      if [ -z "$(ls -A build/libs/*.jar 2>/dev/null)" ]; then \
        echo "❌ 错误：BUILD_IN_DOCKER=false 但找不到外部产物 backend/build/libs/*.jar"; \
        exit 1; \
      fi; \
    fi
 # ==================== 阶段3：运行环境 ====================
 FROM eclipse-temurin:17-jre-jammy
 WORKDIR /app
-# 安装 Nginx 和必要的工具
+# 安装 Nginx、Python 和必要的工具
 RUN apt-get update && \
-    apt-get install -y nginx curl && \
+    apt-get install -y nginx curl tzdata jq python3 python3-flask python3-requests && \
    rm -rf /var/lib/apt/lists/* && \
    rm -rf /etc/nginx/sites-enabled/default
 # 从构建阶段复制文件
 # 当 BUILD_IN_DOCKER=false 时，构建阶段已经复制了外部产物
 COPY --from=frontend-build /app/frontend/dist /usr/share/nginx/html
 COPY --from=backend-build /app/backend/build/libs/*.jar app.jar
 # 复制 Nginx 配置
 COPY docker/nginx.conf /etc/nginx/nginx.conf
-# 创建启动脚本
+# 创建更新服务相关目录和脚本
 RUN mkdir -p /app/updates /app/backups /var/log/polyhermes
 COPY docker/update-service.py /app/update-service.py
 COPY docker/start.sh /app/start.sh
 RUN chmod +x /app/start.sh
-# 创建非 root 用户（用于运行后端应用）
+# 记录初始版本（从构建参数）
 ARG VERSION=dev
 ARG GIT_TAG=dev
 RUN echo "{\"version\":\"${VERSION}\",\"tag\":\"${GIT_TAG}\",\"buildTime\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}" > /app/version.json
 # 创建非 root 用户
 RUN useradd -m -u 1000 appuser
-# 设置目录权限（Nginx 以 root 运行，后端应用以 appuser 运行）
+# 设置目录权限
 RUN mkdir -p /var/log/nginx /var/lib/nginx /var/cache/nginx /var/run && \
    chown -R appuser:appuser /app && \
-    chown -R root:root /usr/share/nginx/html && \
+    chown -R root:root /usr/share/nginx/html /var/log/nginx /var/lib/nginx /var/cache/nginx /etc/nginx /var/run
    chown -R root:root /var/log/nginx && \
    chown -R root:root /var/lib/nginx && \
    chown -R root:root /var/cache/nginx && \
    chown -R root:root /etc/nginx && \
    chown -R root:root /var/run
 # 保持 root 用户（Nginx 需要 root 权限绑定 80 端口）
 # USER appuser
 # 暴露端口
 EXPOSE 80
 # 健康检查
 HEALTHCHECK --interval=30s --timeout=3s --start-period=40s --retries=3 \
-  CMD curl -f http://localhost/api/health || exit 1
+  CMD curl -f http://localhost/api/system/health || exit 1
-# 启动服务（同时启动 Nginx 和后端）
+# 启动服务
 ENTRYPOINT ["/app/start.sh"]
@@ -0,0 +1,301 @@
 # PolyHermes 动态更新功能实施完成总结
 ## ✅ 全部完成！
 **实施时间**: 2026-01-21  
 **总文件修改**: 12个  
 **前端新增**: 1个组件  
 **后端新增**: 1个服务  
 **总代码行数**: 约2000行
 ---
 ## 📂 文件清单
 ### 后端实施（已完成）
 1. ✅ `Dockerfile` - 混合编译方案
 2. ✅ `docker/update-service.py` - P Python Flask 更新服务（573行）
 3. ✅ `docker/start.sh` - 启动3个进程
 4. ✅ `docker/nginx.conf` - Nginx 代理配置
 5. ✅ `docker-compose.yml` - 环境变量
 6. ✅ `docker-compose.test.yml` - 测试环境
 7. ✅ `.github/workflows/docker-build.yml` - CI/CD
 ### 前端实施（已完成）
 8. ✅ `frontend/src/pages/SystemUpdate.tsx` - 系统更新组件（334行）
 9. ✅ `frontend/src/pages/SystemSettings.tsx` - 集成到系统设置
 ### 文档
 10. ✅ `docs/zh/DYNAMIC_UPDATE.md` - 完整技术文档
 11. ✅ `docs/zh/IMPLEMENTATION_SUMMARY.md` - 实施总结
 12. ✅ `verify-implementation.sh` - 验证脚本
 ---
 ## 🎯 核心功能
 ### 1. 混合编译策略
 - **GitHub Actions**: 编译1次，8分钟完成
 - **本地 deploy.sh**: 完全兼容，Docker内编译
 - **构建参数**: `BUILD_IN_DOCKER` 控制编译位置
 ### 2. Pre-release 测试
 - 测试版本不推送 `latest` 标签
 - 测试版本不触发 Telegram 通知
 - 环境变量 `ALLOW_PRERELEASE=true` 启用检测
 ### 3. 更新流程
 ```
 检查版本 → 下载更新包 → 备份 → 替换文件 → 重启服务 → 健康检查 → 回滚（失败时）
 ```
 ### 4. 架构特点
 - **Nginx 直接代理**: `/api/update/*` → Python:9090
 - **权限验证**: Python 调用后端 `/api/auth/verify`
 - **独立服务**: 更新服务与主应用分离
 - **版本追踪**: `/app/version.json`
 ### 5. 前端UI
 - 实时进度显示
 - 版本对比
 - Release Notes 展示
 - 一键升级
 - 自动刷新
 ---
 ## 🚀 使用流程
 ### 开发测试（Pre-release）
 ```bash
 # 1. 提交代码
 git add .
 git commit -m "feat: 动态更新功能"
 git push origin dynamic_load
 # 2. 创建测试 tag
 git tag v1.3.0-beta
 git push origin v1.3.0-beta
 # 3. GitHub 创建 Pre-release
 # - Tag: v1.3.0-beta  
 # - ✅ 勾选 "This is a pre-release"
 # - 发布
 # 4. GitHub Actions 自动执行
 # - 编译前后端
 # - 打包更新包
 # - 上传到 Release Assets
 # - 构建 Docker 镜像（仅 v1.3.0-beta 标签）
 # -❌不推送 latest
 # - ❌ 不发送 Telegram
 # 5. 测试环境部署
 docker pull wrbug/polyhermes:v1.3.0-beta
 docker-compose -f docker-compose.test.yml up -d
 # 6. 测试更新功能
 # - 访问系统设置 → 系统更新
 # - 点击"检查更新"（应该检测到 v1.3.0-beta）
 # - 点击"立即升级"
 # - 验证更新流程
 ```
 ### 生产发布
 ```bash
 # 测试通过后，创建正式版本
 git tag v1.3.0
 git push origin v1.3.0
 # GitHub 创建 Release
 # - Tag: v1.3.0
 # - ❌ 不勾选 "pre-release"
 # - 发布
 # GitHub Actions 自动执行
 # - 编译前后端
 # - 打包更新包
 # - 上传到 Release Assets
 # - 构建 Docker 镜像（v1.3.0 + latest）
 # - ✅ 推送 latest
 # - ✅ 发送 Telegram 通知
 # 生产环境更新
 # 1. 用户访问系统设置 → 系统更新
 # 2. 点击"检查更新"
 # 3. 点击"立即升级"
 # 4. 等待30-60秒
 # 5. 页面自动刷新
 ```
 ---
 ## 📋 验证清单
 运行验证脚本：
 ```bash
 ./verify-implementation.sh
 ```
 **预期输出**：
 ```
 ========================================
  PolyHermes 动态更新功能验证
 ========================================
 📋 检查文件...
  ✅ Dockerfile
  ✅ docker/update-service.py
  ✅ docker/start.sh
  ✅ docker/nginx.conf
  ✅ docker-compose.yml
  ✅ docker-compose.test.yml
  ✅ .github/workflows/docker-build.yml
  ✅ docs/zh/DYNAMIC_UPDATE.md
 📋 检查关键配置...
  ✅ Dockerfile 包含 BUILD_IN_DOCKER 参数
  ✅ Dockerfile 安装 Python
  ✅ Nginx 配置包含更新服务代理
  ✅ docker-compose.yml 包含 ALLOW_PRERELEASE
  ✅ GitHub Actions 包含 Pre-release 检测
  ✅ GitHub Actions 包含后端编译步骤
 📋 检查 Python 语法...
  ✅ update-service.py 语法正确
 ========================================
  ✅ 验证通过！所有检查项正常
 ========================================
 ```
 ---
 ## ⚠️ 注意事项
 ### 必须检查的端点
 1. **健康检查端点**: `/api/system/health`
   - 用于检查后端服务是否正常
   - 如果不存在，需要修改 `Dockerfile` 和 `start.sh` 中的健康检查URL
 2. **权限验证端点**: `/api/auth/verify`
   - 用于验证管理员权限
   - 如果不存在，有两个选择：
     - 在后端创建此端点
     - 或修改 `update-service.py` 中的权限验证逻辑
 ---
 ## 🎨 前端UI特性
 - ✅ 当前版本显示
 - ✅ 检查更新按钮
 - ✅ 更新信息展示（版本、发布时间、Release Notes）
 - ✅ 实时进度条（0-100%）
 - ✅ 状态消息显示
 - ✅ 一键升级按钮
 - ✅ 错误处理和显示
 - ✅ 更新成功后自动刷新
 - ✅ 使用说明提示
 ---
 ## 📚 API 文档
 ### 前端调用的API
 | 端点 | 方法 | 说明 | 权限 |
 |------|------|------|------|
 | `/api/update/version` | GET | 获取当前版本 | 无 |
 | `/api/update/check` | GET | 检查更新 | 无 |
 | `/api/update/execute` | POST | 执行更新 | Admin |
 | `/api/update/status` | GET | 获取更新状态 | 无 |
 | `/api/update/logs` | GET | 获取更新日志 | Admin |
 ### 响应格式
 ```json
 {
  "code": 0,
  "data": {
    ...
  },
  "message": "success"
 }
 ```
 ---
 ## 🐛 故障排查
 ### 问题1：健康检查失败
 **错误信息**: `后端服务启动超时`
 **解决方案**:
 ```bash
 # 检查健康检查端点
 curl http://localhost:8000/api/system/health
 # 如果404，修改 Dockerfile 和 start.sh
 # 将 /api/system/health 改为实际存在的端点
 ```
 ### 问题2：权限验证失败
 **错误信息**: `需要管理员权限`
 **解决方案**:
 1. 确保前端已登录且有 Admin Token
 2. 检查 `/api/auth/verify` 端点是否存在
 3. 或修改 `update-service.py` 的权限验证逻辑
 ### 问题3：更新包下载失败
 **错误信息**: `下载更新包失败`
 **可能原因**:
 - GitHub Release 未发布
 - 更新包文件名不符合规范
 - 网络连接问题
 **解决方案**:
 ```bash
 # 检查 Release Assets
 curl https://api.github.com/repos/WrBug/PolyHermes/releases/latest
 # 确保文件名格式：polyhermes-{tag}-update.tar.gz
 ```
 ---
 ## 📊 性能指标
 | 指标 | 数值 |
 |------|------|
 | **GitHub Actions 构建时间** | ~8分钟 |
 | **更新包大小** | ~50MB |
 | **更新总时长** | 30-60秒 |
 | **下载时间** | 5-15秒（依网络）|
 | **备份时间** | 2-5秒 |
 | **解压时间** | 2-3秒 |
 | **重启时间** | 10-15秒 |
 | **健康检查** | 最多30秒 |
 ---
 ##✅ 实施完成状态
 **后端**: ✅ 100% 完成  
 **前端**: ✅ 100% 完成  
 **文档**: ✅ 100% 完成  
 **测试**: ⏳ 待验证
 ---
 **状态**: 🎉 **实施完成，准备测试！**
 **下一步**: 创建 Pre-release 进行测试验证
@@ -0,0 +1,31 @@
 # PolyHermes 动态更新功能 - 遗漏检查报告
 ## 检查时间
 2026-01-21 01:46
 ## 已发现并修复的遗漏
 ### 1. ✅ docker-compose.prod.yml 缺少环境变量
 **问题**: 生产环境配置文件缺少动态更新相关的环境变量
 **修复**: 已添加 `ALLOW_PRERELEASE` 和 `GITHUB_REPO` 环境变量
 ### 2. ✅ 后端缺少权限验证端点
 **问题**: Python 更新服务需要调用 `/api/auth/verify` 验证管理员权限，但该端点不存在
 **修复**: 已在 `AuthController.kt` 中添加 `verify` 端点
 ## 继续检查项目
 ### 3. 备份文件检查
 检查是否有遗留的备份文件需要清理...
 ### 4. .gitignore 文件
 检查是否需要添加临时文件到 .gitignore...
 ### 5. 前端国际化
 检查是否需要为系统更新添加多语言支持...
 ### 6. README 文档
 检查是否需要更新 README 说明新功能...
 ### 7. 依赖检查
 检查 Python 依赖是否完整（Flask, requests）...
@@ -1,7 +1,8 @@
 # PolyHermes
 [![GitHub](https://img.shields.io/badge/GitHub-WrBug%2FPolyHermes-blue?logo=github)](https://github.com/WrBug/PolyHermes)
-[![Twitter](https://img.shields.io/badge/Twitter-@quant__tr-blue?logo=twitter)](https://x.com/quant_tr)
+[![Twitter](https://img.shields.io/badge/Twitter-@polyhermes-blue?logo=twitter)](https://x.com/polyhermes)
 [![Docker](https://img.shields.io/docker/v/wrbug/polyhermes?label=Docker&logo=docker)](https://hub.docker.com/r/wrbug/polyhermes)
 > 🌐 **Language**: [English](README_EN.md) | 中文
@@ -115,6 +116,7 @@
 - **API 健康检查**：实时监控 Polymarket API 的健康状态
 - **用户管理**：管理系统用户，支持添加、编辑、删除用户
 - **公告管理**：查看系统公告和更新信息
 - **动态更新**：支持在线更新系统版本，无需重新部署容器
 ### 🚀 技术特性
@@ -228,6 +230,25 @@ docker-compose up -d
 # image: wrbug/polyhermes:v1.0.0
 ```
 **更新 Docker 版本**：
 ```bash
 # 1. 停止当前容器
 docker-compose -f docker-compose.prod.yml down
 # 2. 拉取最新镜像
 docker pull wrbug/polyhermes:latest
 # 3. 重新启动服务
 docker-compose -f docker-compose.prod.yml up -d
 # 或更新到特定版本（例如 v1.0.1）
 # 修改 docker-compose.prod.yml 中的镜像标签为: image: wrbug/polyhermes:v1.0.1
 # 然后执行: docker-compose -f docker-compose.prod.yml up -d
 ```
 详细更新说明请参考：[部署文档 - 更新 Docker 版本](docs/zh/DEPLOYMENT.md#更新-docker-版本)
 2. **本地构建部署（开发环境）**
 ```bash
@@ -251,7 +272,6 @@ DB_USERNAME=root
 DB_PASSWORD=your_password_here
 SPRING_PROFILES_ACTIVE=prod
 SERVER_PORT=80
 POLYGON_RPC_URL=https://polygon-rpc.com
 JWT_SECRET=your-jwt-secret-key-change-in-production
 ADMIN_RESET_PASSWORD_KEY=your-admin-reset-key-change-in-production
 EOF
@@ -318,7 +338,6 @@ cd frontend
 | `DB_USERNAME` | 数据库用户名 | `root` |
 | `DB_PASSWORD` | 数据库密码 | - |
 | `SERVER_PORT` | 后端服务端口 | `8000` |
 | `POLYGON_RPC_URL` | Polygon RPC 地址 | `https://polygon-rpc.com` |
 | `JWT_SECRET` | JWT 密钥 | - |
 | `ADMIN_RESET_PASSWORD_KEY` | 管理员密码重置密钥 | - |
 | `CRYPTO_SECRET_KEY` | 加密密钥（用于加密存储私钥和 API Key） | - |
@@ -379,6 +398,7 @@ cd frontend
 - [开发文档](docs/zh/DEVELOPMENT.md) - 开发指南
 - [跟单系统需求文档](docs/zh/copy-trading-requirements.md) - 后端 API 接口文档
 - [前端需求文档](docs/zh/copy-trading-frontend-requirements.md) - 前端功能文档
 - [动态更新文档](docs/zh/DYNAMIC_UPDATE.md) - 动态更新功能说明
 ### 🤝 贡献指南
@@ -414,7 +434,8 @@ cd frontend
 ## 🔗 相关链接
 - [GitHub 仓库](https://github.com/WrBug/PolyHermes)
- [Twitter](https://x.com/quant_tr)
+- [Twitter](https://x.com/polyhermes)
 - [Telegram 群组](https://t.me/polyhermes)
 - [Polymarket 官网](https://polymarket.com)
 - [Polymarket API 文档](https://docs.polymarket.com)
@@ -1,7 +1,8 @@
 # PolyHermes
 [![GitHub](https://img.shields.io/badge/GitHub-WrBug%2FPolyHermes-blue?logo=github)](https://github.com/WrBug/PolyHermes)
-[![Twitter](https://img.shields.io/badge/Twitter-@quant__tr-blue?logo=twitter)](https://x.com/quant_tr)
+[![Twitter](https://img.shields.io/badge/Twitter-@polyhermes-blue?logo=twitter)](https://x.com/polyhermes)
 [![Docker](https://img.shields.io/docker/v/wrbug/polyhermes?label=Docker&logo=docker)](https://hub.docker.com/r/wrbug/polyhermes)
 > 🌐 **Language**: English | [中文](README.md)
@@ -228,6 +229,25 @@ docker-compose up -d
 # image: wrbug/polyhermes:v1.0.0
 ```
 **Update Docker Version**:
 ```bash
 # 1. Stop current containers
 docker-compose -f docker-compose.prod.yml down
 # 2. Pull latest image
 docker pull wrbug/polyhermes:latest
 # 3. Restart services
 docker-compose -f docker-compose.prod.yml up -d
 # Or update to specific version (e.g., v1.0.1)
 # Modify image tag in docker-compose.prod.yml to: image: wrbug/polyhermes:v1.0.1
 # Then run: docker-compose -f docker-compose.prod.yml up -d
 ```
 For detailed update instructions, please refer to: [Deployment Guide - Update Docker Version](docs/en/DEPLOYMENT.md#update-docker-version)
 2. **Local Build Deployment (Development Environment)**
 ```bash
@@ -251,7 +271,6 @@ DB_USERNAME=root
 DB_PASSWORD=your_password_here
 SPRING_PROFILES_ACTIVE=prod
 SERVER_PORT=80
 POLYGON_RPC_URL=https://polygon-rpc.com
 JWT_SECRET=your-jwt-secret-key-change-in-production
 ADMIN_RESET_PASSWORD_KEY=your-admin-reset-key-change-in-production
 EOF
@@ -318,7 +337,6 @@ cd frontend
 | `DB_USERNAME` | Database username | `root` |
 | `DB_PASSWORD` | Database password | - |
 | `SERVER_PORT` | Backend service port | `8000` |
 | `POLYGON_RPC_URL` | Polygon RPC address | `https://polygon-rpc.com` |
 | `JWT_SECRET` | JWT secret key | - |
 | `ADMIN_RESET_PASSWORD_KEY` | Admin password reset key | - |
 | `CRYPTO_SECRET_KEY` | Encryption key (for encrypting stored private keys and API Keys) | - |
@@ -414,7 +432,8 @@ This project is licensed under the MIT License. See the [LICENSE](LICENSE) file
 ## 🔗 Related Links
 - [GitHub Repository](https://github.com/WrBug/PolyHermes)
- [Twitter](https://x.com/quant_tr)
+- [Twitter](https://x.com/polyhermes)
 - [Telegram Group](https://t.me/polyhermes)
 - [Polymarket Official Website](https://polymarket.com)
 - [Polymarket API Documentation](https://docs.polymarket.com)
@@ -0,0 +1,971 @@
 # v1.1.10
 ## 🚀 主要功能
 ### 📢 推送已过滤订单功能
 - **新增推送已过滤订单功能（pushFilteredOrders）**，默认关闭
  - 支持在模板和跟单配置中配置是否推送被过滤的订单通知
  - 开启后，当订单因过滤条件（价格区间、订单深度、价差、仓位限制等）被过滤时，会发送 Telegram 通知
  - 帮助用户了解哪些订单被过滤以及过滤原因
 - **数据库迁移**：
  - 添加 `push_filtered_orders` 字段到 `copy_trading_templates` 表
  - 添加 `push_filtered_orders` 字段到 `copy_trading` 表
  - 迁移脚本：`V24__add_push_filtered_orders_to_templates.sql`
 - **后端实现**：
  - 在实体类（`CopyTradingTemplate`、`CopyTrading`）中添加 `pushFilteredOrders` 字段
  - 在 DTO 中添加字段支持（创建、更新、查询）
  - 在 Service 中处理字段的创建、更新和传递
  - 在发送过滤订单通知时检查 `pushFilteredOrders` 字段，只有为 `true` 时才发送
 - **前端实现**：
  - 在模板新增、编辑、推送页面添加"推送已过滤订单"开关
  - 在跟单配置新增、编辑页面添加"推送已过滤订单"开关
  - 从模板创建跟单配置时，自动填充 `pushFilteredOrders` 字段
  - 支持多语言（中文、繁体中文、英文）
 ### 🔍 优化订单列表筛选功能
 - **支持按市场标题搜索**：
  - 买入订单列表：添加市场标题筛选，移除方向筛选
  - 卖出订单列表：添加市场标题筛选，将方向筛选改为状态筛选
  - 已成交订单列表：添加市场标题筛选和市场列显示
 - **改进分组体验**：
  - 记录用户的分组偏好到 localStorage，跨会话持久化
  - 所有搜索输入框添加 0.5 秒防抖优化，提升性能
 - **后端优化**：
  - `MarketGroupedOrdersRequest` 添加 `marketId` 和 `marketTitle` 字段
  - 买入/卖出订单分组接口支持市场 ID 模糊匹配和市场标题关键字筛选
 ### ⚡ 优化跟单关系统计性能
 - **移除未实现盈亏计算**：
  - 移除未实现盈亏和持仓价值的计算逻辑
  - 总盈亏现在仅包含已实现盈亏，计算更准确
  - 简化盈亏百分比计算，仅基于已实现盈亏
 - **性能提升**：
  - 从 1+N 次网络请求减少到 0 次
  - 删除不再使用的方法和依赖注入
  - 统计查询速度显著提升
 ### 🐳 Docker 容器时区配置
 - **支持通过 .env 自定义时区**：
  - 在 `docker-compose.yml` 和 `docker-compose.prod.yml` 中添加时区环境变量配置
  - 支持通过 `TZ` 环境变量自定义容器时区
  - 默认使用系统时区
 ## 🐛 Bug 修复
 ### 修复跟单配置更新时清空可选字段无法保存的问题
 - **问题**：修改跟单配置时，清空价格区间、最大仓位数量、截止时间等可选字段后，无法保存到数据库
 - **修复**：
  - 修复价格区间（`minPrice`/`maxPrice`）清空后无法保存的问题
  - 修复最大仓位数量（`maxPositionCount`）清空后无法保存的问题
  - 修复市场截止时间（`maxMarketEndDate`）清空后无法保存的问题
  - 修复其他可选字段（`minOrderDepth`/`maxSpread`/`maxPositionValue`）清空后无法保存的问题
 - **实现方案**：
  - 前端：清空字段时传空字符串或 `-1` 标记，让后端识别为清空操作
  - 后端：处理空字符串和 `-1` 标记，正确设置为 `null` 以清空字段
 ### 修复新建和编辑页面的截止时间输入框交互问题
 - **问题**：删除截止时间输入框内容后，失去焦点会自动填充 1
 - **修复**：
  - 将 `min` 从 `1` 改为 `0`，允许空值
  - 优化 `onChange` 处理，当值为 `0`、`null` 或 `undefined` 时设置为 `undefined`（清空）
  - 添加 `onBlur` 处理，确保失去焦点时如果值为空或 `0`，设置为 `undefined`
  - 修改 `parser`，空值时返回空字符串而不是 `0`
 ### 修复订单通知重复发送和时间显示问题
 - **修复并发导致的重复通知问题**：
  - 在 `OrderStatusUpdateService` 中实现双重检查机制
  - 先保存订单标记为已发送，再重新查询数据库检查
  - 防止定时任务并发时重复发送同一订单的通知
  - 同时修复买入订单和卖出订单的通知逻辑
 - **修复 Telegram 通知时间显示**：
  - `TelegramNotificationService.sendOrderSuccessNotification` 添加 `orderTime` 参数
  - 使用订单的 `createdAt` 时间戳作为通知显示时间
  - 而不是使用当前通知发送时间
  - 更准确反映订单的实际创建时间
 ### 修复新建跟单配置时 pushFilteredOrders 字段未生效的问题
 - **问题**：新建跟单配置时，即使设置了 `pushFilteredOrders: true`，也没有生效
 - **修复**：
  - 修复手动输入模式下 `pushFilteredOrders` 被硬编码为 `false` 的问题
  - 修复从模板填充表单时未加载 `pushFilteredOrders` 的问题
  - 添加 `CopyTradingTemplate` 接口的 `pushFilteredOrders` 字段定义
 ## 📝 技术细节
 ### 数据库变更
 - **迁移脚本**：`V24__add_push_filtered_orders_to_templates.sql`
 - **变更内容**：
  - `copy_trading_templates.push_filtered_orders`: BOOLEAN NOT NULL DEFAULT FALSE
  - `copy_trading.push_filtered_orders`: BOOLEAN NOT NULL DEFAULT FALSE
 - **自动执行**：升级时会自动执行迁移脚本
 ### API 变更
 - **无新增接口**
 - **无移除接口**
 - **请求/响应变更**：
  - `CopyTradingCreateRequest` 添加 `pushFilteredOrders` 字段
  - `CopyTradingUpdateRequest` 添加 `pushFilteredOrders` 字段
  - `TemplateCreateRequest` 添加 `pushFilteredOrders` 字段
  - `TemplateUpdateRequest` 添加 `pushFilteredOrders` 字段
  - `MarketGroupedOrdersRequest` 添加 `marketId` 和 `marketTitle` 字段
 ### 前端变更
 - **新增字段**：
  - `CopyTradingTemplate` 接口添加 `pushFilteredOrders` 字段
 - **组件更新**：
  - 模板新增、编辑、推送页面添加"推送已过滤订单"开关
  - 跟单配置新增、编辑页面添加"推送已过滤订单"开关
  - 优化截止时间输入框交互逻辑
 - **多语言支持**：
  - 添加中文、繁体中文、英文翻译
 ## 📊 变更统计
 - **提交数量**：6 个提交
 - **文件变更**：30 个文件
 - **代码变更**：+651 行 / -555 行（净增加 96 行）
 ### 详细文件变更
 **后端变更**：
 - `CopyTrading.kt` - 添加 `pushFilteredOrders` 字段（+3 行）
 - `CopyTradingTemplate.kt` - 添加 `pushFilteredOrders` 字段（+3 行）
 - `CopyTradingDto.kt` - 添加 `pushFilteredOrders` 字段支持（+3 行）
 - `CopyTradingTemplateDto.kt` - 添加 `pushFilteredOrders` 字段支持（+10 行）
 - `CopyTradingService.kt` - 处理 `pushFilteredOrders` 字段和清空字段逻辑（+93 行）
 - `CopyTradingTemplateService.kt` - 处理 `pushFilteredOrders` 字段（+8 行）
 - `CopyOrderTrackingService.kt` - 检查 `pushFilteredOrders` 字段发送通知（+42 行）
 - `CopyTradingStatisticsService.kt` - 优化统计性能（-328 行）
 - `OrderStatusUpdateService.kt` - 修复重复通知问题（+142 行）
 - `TelegramNotificationService.kt` - 添加订单时间参数（+17 行）
 - `V24__add_push_filtered_orders_to_templates.sql` - 数据库迁移脚本（+13 行）
 **前端变更**：
 - `AddModal.tsx` - 添加 `pushFilteredOrders` 字段和优化截止时间输入框（+40 行）
 - `EditModal.tsx` - 添加 `pushFilteredOrders` 字段和优化截止时间输入框（+59 行）
 - `TemplateAdd.tsx` - 添加 `pushFilteredOrders` 字段（+15 行）
 - `TemplateEdit.tsx` - 添加 `pushFilteredOrders` 字段（+15 行）
 - `TemplateList.tsx` - 添加 `pushFilteredOrders` 字段（+13 行）
 - `BuyOrdersTab.tsx` - 优化筛选功能（+94 行）
 - `SellOrdersTab.tsx` - 优化筛选功能（+77 行）
 - `MatchedOrdersTab.tsx` - 优化筛选功能（+26 行）
 - `types/index.ts` - 添加 `pushFilteredOrders` 字段定义（+6 行）
 - `locales/*/common.json` - 添加多语言翻译（+31 行）
 **配置文件变更**：
 - `docker-compose.yml` - 添加时区配置（+5 行）
 - `docker-compose.prod.yml` - 添加时区配置（+5 行）
 - `Dockerfile` - 优化构建配置（+4 行）
 ## 🔄 主要提交
 ```
 9c303e0 feat: 添加推送已过滤订单功能并修复相关问题
 cb8e469 fix: 修复跟单配置更新时清空可选字段无法保存的问题
 279806d feat: 优化订单列表筛选功能，支持按市场标题搜索并改进分组体验
 90fa487 refactor: 移除未实现盈亏计算以优化跟单关系统计性能
 b58bb26 feat: 添加 Docker 容器时区配置，支持通过 .env 自定义
 6af76c4 fix: 修复订单通知重复发送和时间显示问题
 ```
 ## 🎯 升级建议
 1. **数据库迁移**：本次版本包含数据库迁移脚本，升级时会自动执行
   - 自动添加 `push_filtered_orders` 字段到模板表和跟单配置表
   - 现有数据不受影响，新字段默认值为 `false`
 2. **配置更新**：
   - 可选：在 `.env` 文件中添加 `TZ` 环境变量自定义容器时区
   - 无需其他配置变更
 3. **兼容性**：
   - 完全向后兼容，不影响现有功能
   - API 变更都是新增字段，不影响现有调用
 ## 📦 Docker 镜像
 Docker 镜像会自动构建并推送到 Docker Hub：
 - `wrbug/polyhermes:v1.1.10`
 - `wrbug/polyhermes:latest`（如果这是最新版本）
 ## 🔗 相关链接
 - [GitHub Release](https://github.com/WrBug/PolyHermes/releases/tag/v1.1.10)
 - [完整更新日志](https://github.com/WrBug/PolyHermes/compare/v1.1.9...v1.1.10)
 ---
 **发布日期**：2026-01-12
 ---
 # v1.1.9
 ## 🐛 Bug 修复
 ### 修复盈亏统计计算错误问题
 - **问题**：在仓位检查时，刚创建的订单可能因仓位更新延迟被误判为已卖出，导致盈亏统计计算错误
 - **修复**：
  - 优化自动卖出订单筛选逻辑，在 SQL 层直接过滤创建时间超过阈值的订单
  - 新增 `findUnmatchedBuyOrdersByOutcomeIndexOlderThan` Repository 方法，提高查询效率
  - 统一使用 2 分钟阈值保护刚创建的订单，避免误判
  - 两个场景都使用 SQL 过滤：
    * 场景1：仓位不存在时，延迟检测使用 SQL 过滤
    * 场景2：仓位部分存在时，FIFO 匹配使用 SQL 过滤
 - **优化效果**：
  - SQL 层面直接过滤，减少数据传输，提高查询效率
  - 代码更简洁，逻辑更清晰
  - 刚创建的订单（< 2 分钟）不会被误判为已卖出
  - 确保盈亏统计计算的准确性
 ## 📝 技术细节
 - **Repository 变更**：
  - 新增 `findUnmatchedBuyOrdersByOutcomeIndexOlderThan` 方法
  - 在 SQL 查询中添加 `createdAt < :thresholdTime` 条件过滤
 - **Service 变更**：
  - `PositionCheckService` 中两个场景都使用 SQL 过滤替代内存过滤
  - 统一使用 2 分钟（120000 毫秒）作为时间阈值
 ## 📊 变更统计
 - **提交数量**：1 个提交
 - **文件变更**：2 个文件
 - **代码变更**：+57 行 / -19 行（净增加 38 行）
 ### 详细文件变更
 **后端变更**：
 - `CopyOrderTrackingRepository.kt` - 新增 SQL 查询方法（+18 行）
 - `PositionCheckService.kt` - 优化订单筛选逻辑（+39 行 / -19 行）
 ## 🔄 主要提交
 ```
 6ad4024 fix: 优化自动卖出订单筛选逻辑，避免刚创建的订单被误判
 ```
 ## 🎯 升级建议
 1. **数据库迁移**：无需数据库迁移，可直接升级
 2. **配置更新**：无需配置变更
 3. **兼容性**：完全向后兼容，不影响现有功能
 ## 📦 Docker 镜像
 Docker 镜像会自动构建并推送到 Docker Hub：
 - `wrbug/polyhermes:v1.1.9`
 - `wrbug/polyhermes:latest`（如果这是最新版本）
 ## 🔗 相关链接
 - [GitHub Release](https://github.com/WrBug/PolyHermes/releases/tag/v1.1.9)
 ---
 # v1.1.8
 ## 🚀 主要功能
 ### ⚡ Polymarket Activity WebSocket 双重监听方案
 - **新增 PolymarketActivityWsService**：通过 Activity WebSocket 实时监听 Leader 交易
  - 延迟 < 100ms，适合快速跟单场景
  - 订阅全局 activity 交易流，客户端过滤 Leader 地址
  - 支持动态添加/移除 Leader 监听
  - 地址筛选忽略大小写，提高匹配准确性
 - **双重监听机制**：
  - Activity WebSocket（低延迟，< 100ms）：作为主要监听方式
  - On-Chain WebSocket（高可靠性，~2-3s）：作为兜底监听方式
  - 自动去重，避免重复处理同一笔交易
 - **协议支持**：
  - 支持 `connection_id` 字段
  - 优先使用消息中的 `outcomeIndex` 字段，fallback 到从 `outcome` 解析
 - **参考文档**：
  - [双重监听方案文档](docs/zh/copy-trading-dual-monitoring-plan.md)
  - [Activity WebSocket API 文档](docs/zh/polymarket-activity-websocket-api.md)
 ### 🔧 支持同一用户创建多个相同 Leader 的跟单配置
 - **移除唯一约束**：允许同一用户创建多个跟单同一个 Leader 的配置
 - **应用场景**：支持不同参数（比例、过滤条件等）的多配置跟单
 - **数据库迁移**：`V23__remove_unique_constraint_from_copy_trading.sql`
 ### 🎯 市场截止时间筛选功能
 - **新增市场截止时间过滤**：支持设置跟单配置的最大市场截止时间
 - **自动过滤过期市场**：系统会自动跳过超过设定截止时间的市场
 - **数据库字段**：`max_market_end_date`（时间戳，单位：秒）
 - **数据库迁移**：`V22__add_max_market_end_date_to_copy_trading.sql`
 ### 🔍 关键字过滤功能
 - **新增关键字过滤**：支持在黑名单或白名单模式下过滤市场标题关键字
 - **过滤模式**：
  - `DISABLED`：禁用关键字过滤
  - `BLACKLIST`：黑名单模式（包含关键字的市场会被过滤）
  - `WHITELIST`：白名单模式（只允许包含关键字的市场）
 - **多关键字支持**：支持多个关键字，以 JSON 数组格式存储
 - **数据库字段**：`keyword_filter_mode` 和 `keywords`（JSON 数组）
 - **数据库迁移**：`V20__add_keyword_filter.sql`
 ### 📊 订单列表功能重构
 - **按市场分组显示**：订单列表按市场分组，便于查看和管理
 - **市场信息展示**：
  - 显示市场标题和 slug
  - 支持跳转到 Polymarket 市场页面
  - 显示市场基本信息（标题、slug、截止时间等）
 - **订单 ID 复制功能**：一键复制订单 ID，方便查询和调试
 - **UI/UX 优化**：
  - 优化订单列表展示样式
  - 改进移动端适配
 ### 📈 市场信息管理和缓存优化
 - **新增 MarketService**：统一管理市场信息查询和缓存
  - 使用 LRU 缓存提高查询性能
  - 支持从 Gamma API 和 CLOB API 查询市场信息
  - 自动缓存市场信息，减少 API 调用
 - **新增 Market 实体和表**：持久化存储市场信息
  - 存储市场标题、slug、eventSlug、endDate 等基本信息
  - 支持通过 marketId 快速查询市场信息
 - **数据库迁移**：
  - `V19__create_markets_table.sql`：创建市场信息表
  - `V21__add_event_slug_to_markets.sql`：添加 eventSlug 字段
 - **市场信息轮询服务**：定期更新市场信息，保持数据新鲜度
 ## 🐛 Bug 修复
 ### 前端 TypeScript 类型错误修复
 - **修复 InputNumber parser 类型错误**：`parser` 函数应返回 `number` 而不是 `string`
 - **修复文件**：
  - `src/pages/CopyTradingOrders/AddModal.tsx`
  - `src/pages/CopyTradingOrders/EditModal.tsx`
 ## 📝 文档更新
 - **新增双重监听方案文档**：详细说明 Activity WebSocket 和 On-Chain WebSocket 的双重监听机制
 - **新增 Activity WebSocket API 文档**：详细的 API 格式和消息结构说明
 - **更新开发规范**：JSON 解析规范和 Data Class 规范
 ## 📊 统计信息
 - **61 个文件被修改**
 - **+5125 行新增代码**
 - **-1942 行删除代码**
 - **净增加 3183 行代码**
 ## 🔄 主要提交
 ```
 d376a82 feat: 添加市场信息管理和订单ID复制功能
 2af2c0e feat: 订单列表按市场分组并支持跳转到Polymarket
 9ed5190 feat: 添加关键字过滤功能并优化市场 slug 处理
 0327eaf feat: 添加市场截止时间筛选功能
 a16b6fc feat: 支持同一用户创建多个相同 leader 的跟单配置
 19508dc feat: 实现 Polymarket Activity WebSocket 双重监听方案
 ```
 ## 🎯 升级建议
 1. **数据库迁移**：确保执行所有数据库迁移脚本（V19-V23）
 2. **配置更新**：新版本的 `application.properties` 中添加了 Activity WebSocket URL 配置
 3. **环境变量**：如果使用 Docker 部署，建议更新 `docker-compose.yml` 中的配置
 ## 📦 Docker 镜像
 Docker 镜像会自动构建并推送到 Docker Hub：
 - `wrbug/polyhermes:v1.1.8`
 - `wrbug/polyhermes:latest`（如果这是最新版本）
 ## 🔗 相关链接
 - [GitHub Release](https://github.com/WrBug/PolyHermes/releases/tag/v1.1.8)
 - [双重监听方案文档](docs/zh/copy-trading-dual-monitoring-plan.md)
 - [Activity WebSocket API 文档](docs/zh/polymarket-activity-websocket-api.md)
 ---
 # v1.1.7
 ## 🚀 主要功能
 ### 💰 Polymarket Maker Rebates Program 费率支持
 - **新增费率查询 API 接口** (`getFeeRate`)
  - 支持动态查询 Maker Rebates Program 费率
  - 修正 API 返回字段名：使用 `base_fee` 而非 `fee_rate_bps`（与 TypeScript clob-client 一致）
 - **动态费率获取**
  - 在所有订单创建处动态获取费率：
    * 跟单买入订单 (`processBuyTrade`)
    * 跟单卖出订单 (`matchSellOrder`)
    * 账户卖出订单 (`sellPosition`)
  - 费率获取失败时降级到默认值 "0"，确保系统可用性
  - 添加详细的日志记录，便于监控和调试
 - **参考文档**: https://docs.polymarket.com/developers/market-makers/maker-rebates-program
 ### 🔧 Docker 部署优化
 - **日志级别环境变量支持**
  - 在 `application.properties` 中支持通过 `LOG_LEVEL_ROOT` 和 `LOG_LEVEL_APP` 环境变量配置日志级别
  - 在 `docker-compose.yml` 和 `docker-compose.prod.yml` 中添加日志级别环境变量配置
  - 在 `deploy.sh` 的 `.env` 模板中添加日志级别配置说明
  - 支持通过环境变量动态配置日志级别，无需修改配置文件
  - 默认值：`root=INFO`, `app=DEBUG`
 ## 🐛 Bug 修复
 ### 修复市场条件查询的 RPC 调用错误
 - **问题**：使用错误的函数签名 `conditions(bytes32)` 导致 RPC 调用失败（execution reverted）
 - **修复**：
  - 将错误的 `conditions(bytes32)` 函数调用改为正确的 `getOutcomeSlotCount(bytes32)` 和 `payoutDenominator(bytes32)` 函数调用
  - 修复 `BlockchainService.getCondition` 方法，使用正确的 ConditionalTokens 合约函数签名
  - 改进 `MarketPriceService` 的错误处理：当链上查询出现 RPC 错误时，降级到 CLOB API 或 Gamma API 查询，而不是直接抛出异常，提高容错性
 ### 修复 RPC 错误时误创建自动卖出记录的问题
 - **问题**：当链上查询市场条件出现 RPC 错误（execution reverted）时，系统会误判为市场已卖出，创建错误的自动卖出记录
 - **修复**：
  - 修改 `getPriceFromChainCondition` 返回 `Pair<BigDecimal?, Boolean>`，第二个值表示是否发生 RPC 错误
  - 在 `getCurrentMarketPrice` 中检测到 RPC 错误时抛出异常，`PositionCheckService` 会捕获并跳过该市场的处理
  - 避免在市场不存在或尚未创建时误判为已卖出
 ## 📝 文档更新
 ### 更新 Telegram 群链接
 - 将所有 Telegram 群链接统一更新为 `t.me/polyhermes`
 - 更新了以下文件：
  - `frontend/src/components/Layout.tsx` - 桌面端和移动端导航链接
  - `RELEASE.md` - 相关链接
  - `README.md` 和 `README_EN.md` - 相关链接部分
 ### 添加 Docker 版本徽章
 - 在 README 和 README_EN.md 中添加动态 Docker 版本徽章
 - 使用 shields.io 自动显示 Docker Hub 上 `wrbug/polyhermes` 镜像的最新版本
 - 版本信息自动更新，无需手动维护
 ## 📊 变更统计
 - **提交数量**：5 个提交
 - **文件变更**：16 个文件
 - **代码变更**：+205 行 / -886 行（净减少 681 行）
 ### 详细文件变更
 **后端变更**：
 - `PolymarketClobApi.kt` - 添加费率查询接口（+25 行）
 - `AccountService.kt` - 在订单创建处添加动态费率获取（+11 行）
 - `BlockchainService.kt` - 修复市场条件查询的 RPC 调用错误（+84 行）
 - `MarketPriceService.kt` - 改进错误处理，支持降级到其他数据源（+36 行）
 - `PolymarketClobService.kt` - 添加费率查询服务（+32 行）
 - `CopyOrderTrackingService.kt` - 在跟单订单创建处添加费率获取（+34 行）
 - `PositionCheckService.kt` - 修复 RPC 错误处理逻辑（+2 行）
 - `application.properties` - 添加日志级别环境变量支持（+6 行）
 **前端变更**：
 - `Layout.tsx` - 更新 Telegram 群链接（+4 行）
 **配置文件变更**：
 - `docker-compose.yml` - 添加日志级别环境变量（+4 行）
 - `docker-compose.prod.yml` - 添加日志级别环境变量（+4 行）
 - `deploy.sh` - 添加日志级别配置说明（+5 行）
 **文档变更**：
 - `README.md` - 更新 Telegram 链接，添加 Docker 版本徽章（+2 行）
 - `README_EN.md` - 更新 Telegram 链接，添加 Docker 版本徽章（+2 行）
 - `RELEASE.md` - 更新 Telegram 链接（+4 行）
 - `docs/zh/smart-money-analysis.md` - 删除文档（-836 行）
 ## 🔧 技术细节
 ### API 变更
 - **新增接口**：
  - `POST /api/clob/fee-rate` - 获取 Maker Rebates Program 费率（内部使用）
 - **无移除接口**
 ### 环境变量变更
 - **新增环境变量**：
  - `LOG_LEVEL_ROOT` - Root 日志级别（默认：INFO）
  - `LOG_LEVEL_APP` - 应用日志级别（默认：DEBUG）
 ### 合约调用修复
 - **修复的函数调用**：
  - 从 `conditions(bytes32)` 改为 `getOutcomeSlotCount(bytes32)` 和 `payoutDenominator(bytes32)`
  - 使用正确的 ConditionalTokens 合约函数签名
  - 参考：https://polygonscan.com/address/0x4d97dcd97ec945f40cf65f87097ace5ea0476045#code
 ## 📝 升级说明
 ### 数据库升级
 - **无需数据库迁移**：本次更新不涉及数据库结构变更
 ### 配置更新
 - **可选配置**：新增日志级别环境变量，如不配置将使用默认值
  - `LOG_LEVEL_ROOT=INFO`（默认）
  - `LOG_LEVEL_APP=DEBUG`（默认）
 ### Docker 部署
 - **推荐更新**：使用 Docker Hub 镜像部署的用户，建议更新到最新版本
  ```bash
  docker pull wrbug/polyhermes:latest
  docker-compose -f docker-compose.prod.yml up -d
  ```
 ## 🔗 相关链接
 - **GitHub 仓库**：https://github.com/WrBug/PolyHermes
 - **Twitter**：@polyhermes
 - **Telegram 群组**：https://t.me/polyhermes
 ---
 **发布日期**：2026-01-07
 ---
 # v1.1.5
 ## 🔧 功能优化与改进
 ### 前端优化
 #### 优化 InputNumber 输入框格式化
 - 优化数值输入框的格式化逻辑，修正正则表达式以正确处理整数显示
 - 更新所有相关 InputNumber 组件的 formatter 函数，确保显示准确性
 - 影响的组件：CopyTradingAdd、CopyTradingEdit、EditModal、TemplateAdd、TemplateEdit、TemplateList
 - 影响范围：跟单配置、模板配置中的所有数值输入框
 #### 优化数字显示格式
 - 添加 `formatNumber` 工具函数，自动去除小数尾随零（如 100.00 → 100）
 - 统一所有数值输入框的显示格式，提升用户体验
 ### 后端优化
 #### 优化按比例跟单金额计算逻辑
 - 优化按比例计算的订单金额处理，使用向上取整确保满足最小限制要求
 - 对订单金额进行向上取整处理（保留 2 位小数精度）
 - 自动调整订单数量以满足最小限制要求
 - 使用 `RoundingMode.CEILING` 确保金额满足最小限制
 - 影响范围：按比例跟单的订单创建逻辑
 - 技术细节：
  - 扩展 `BigDecimal.div()` 扩展函数，支持指定精度和舍入模式
  - 在 `CopyOrderTrackingService` 中优化金额计算和验证逻辑
 #### 增强 copyRatio 精度支持
 - 将 copyRatio 字段精度从 DECIMAL(10,2) 增加到 DECIMAL(20,8)
 - 支持更精确的跟单比例设置（最小 0.01%，最大 10000%）
 - 影响的实体：CopyTrading、CopyTradingTemplate
 - 数据库迁移：新增 V18 迁移脚本，自动升级数据库字段精度
 ## 🔧 功能优化
 ### 移除刷新代理钱包接口
 - **移除接口**：
  - `POST /api/accounts/refresh-proxy` - 刷新单个账户的代理地址
  - `POST /api/accounts/refresh-all-proxies` - 刷新所有账户的代理地址
 - **原因**：代理地址应在账户导入时自动计算，无需手动刷新
 - **影响范围**：AccountController、AccountService
 - **向后兼容性**：这些接口已不再使用，移除不影响现有功能
 ### 前端跟单比例配置优化
 - **最小比例**：从 10% 降低到 0.01%，支持更灵活的跟单比例设置
 - **最大比例**：增加到 10000%，满足大比例跟单需求
 - **显示格式**：比例模式显示为百分比（如 "100%" 而不是 "1x"）
 - **输入验证**：增强输入验证，确保比例在合理范围内
 ## 📊 变更统计
 - **提交数量**：3 个提交
 - **文件变更**：15 个文件
 - **代码变更**：+575 行 / -194 行（净增加 381 行）
 ### 详细文件变更
 **后端变更**：
 - `AccountController.kt` - 移除刷新代理钱包接口（-59 行）
 - `AccountService.kt` - 移除刷新代理钱包方法（-79 行）
 - `CopyTrading.kt` - 增加 copyRatio 精度
 - `CopyTradingTemplate.kt` - 增加 copyRatio 精度
 - `CopyOrderTrackingService.kt` - 优化按比例跟单金额计算逻辑（+45 行）
 - `MathExt.kt` - 扩展 div 函数支持精度和舍入模式（+20 行）
 - `V18__increase_copy_ratio_precision.sql` - 数据库迁移脚本（+14 行）
 **前端变更**：
 - `CopyTradingAdd.tsx` - 优化 formatter、优化比例配置（+106 行）
 - `CopyTradingEdit.tsx` - 优化 formatter、优化比例配置（+106 行）
 - `CopyTradingList.tsx` - 优化比例显示格式
 - `CopyTradingOrders/EditModal.tsx` - 优化 formatter、优化比例配置（+106 行）
 - `TemplateAdd.tsx` - 优化 formatter、优化比例配置（+65 行）
 - `TemplateEdit.tsx` - 优化 formatter、优化比例配置（+65 行）
 - `TemplateList.tsx` - 优化 formatter、优化比例配置（+65 行）
 - `utils/index.ts` - 添加 formatNumber 工具函数（+31 行）
 ## 🔧 技术细节
 ### 数据库变更
 - **迁移脚本**：`V18__increase_copy_ratio_precision.sql`
 - **变更内容**：
  - `copy_trading.copy_ratio`: DECIMAL(10,2) → DECIMAL(20,8)
  - `copy_trading_templates.copy_ratio`: DECIMAL(10,2) → DECIMAL(20,8)
 - **自动执行**：升级时会自动执行迁移脚本
 ### API 变更
 - **移除接口**：
  - `POST /api/accounts/refresh-proxy`
  - `POST /api/accounts/refresh-all-proxies`
 - **无新增接口**
 ### 前端变更
 - **工具函数**：新增 `formatNumber()` 函数，用于格式化数字显示
 - **组件更新**：所有数值输入框统一使用新的 formatter 函数
 - **显示优化**：跟单模式的比例显示为百分比格式
 ## 📝 升级说明
 ### 数据库升级
 本次版本包含数据库迁移脚本，升级时会自动执行：
 - 自动增加 `copy_ratio` 字段的精度
 - 现有数据不受影响，精度升级是向后兼容的
 ### 配置变更
 无需额外配置变更。
 ### 兼容性
 - **向后兼容**：所有变更都是向后兼容的
 - **API 兼容**：移除的接口不影响现有功能（这些接口已不再使用）
 - **数据兼容**：数据库字段精度升级不会影响现有数据
 ## 🎯 主要改进
 1. **优化输入框格式化**：优化数值输入框的显示逻辑
 2. **优化跟单金额计算**：确保按比例跟单的金额满足最小限制要求
 3. **提升精度支持**：支持更精确的跟单比例设置（0.01% - 10000%）
 4. **代码清理**：移除不再使用的刷新代理钱包接口
 ## 🔗 相关链接
 - [GitHub Tag](https://github.com/WrBug/PolyHermes/releases/tag/v1.1.5)
 - [变更日志](https://github.com/WrBug/PolyHermes/compare/v1.1.4...v1.1.5)
 ## 🙏 致谢
 感谢所有贡献者和测试用户的反馈与支持！
 ---
 # v1.1.2
 ## 🚀 主要功能
 ### 🐛 修复内存泄漏问题
 - 修复 Retrofit/OkHttpClient 实例重复创建导致的内存泄漏问题
 - 为不需要认证的 API 创建共享的 OkHttpClient 实例（Gamma API、Data API、GitHub API 等）
 - 带认证的 CLOB API 按钱包地址缓存（每个账户一个客户端）
 - RPC API 按 RPC URL 缓存，Builder Relayer API 按 relayerUrl 缓存
 - 添加 `@PreDestroy` 方法清理缓存，确保资源正确释放
 - **效果**：内存占用从运行几小时后从 400MB 涨到 1GB+ 变为保持稳定，大幅减少内存占用
 ### 📊 市场价格服务优化
 - 移除降级查询逻辑，仅保留链上 RPC 查询和 CLOB 订单簿查询
 - 移除 CLOB Trades、Gamma Market Status、Gamma Market Price 查询逻辑
 - 如果所有数据源都失败，抛出明确的异常信息
 - 价格截位到 4 位小数（向下截断，不四舍五入）
 - 简化代码逻辑，提高查询效率和准确性
 ### 🔧 代码架构优化
 - 统一 Gson 使用，改为依赖注入方式
 - 在 `GsonConfig` 中统一配置 Gson Bean（lenient 模式）
 - 所有 Service 类通过构造函数注入 Gson 实例
 - 移除所有 `GsonConverterFactory.create()` 无参调用，统一使用注入的 Gson
 - 提高代码一致性和可维护性
 ### 🗑️ 功能清理
 - 移除下单失败存储数据库的功能
 - 删除 `FailedTrade` 实体类和 `FailedTradeRepository`
 - 从 `CopyOrderTrackingService` 中移除失败交易存储逻辑
 - 创建 Flyway migration V16 删除 `failed_trade` 表
 - 下单失败时仅记录日志，不再存储到数据库，简化数据模型
 ### 🚀 部署优化
 - 自动使用当前分支名作为 Docker 版本号
 - 分支名中的 `/` 自动替换为 `-`（Docker tag 不支持 `/）
 - `docker-compose.yml` 启用 build args，从环境变量读取版本号
 - 前端页面将显示当前分支名作为版本号
 - 如果没有 Git 仓库或获取失败，使用默认值 `dev`
 ## 🐛 Bug 修复
 ### 修复 Flyway Migration 问题
 - 恢复 V1 migration 文件，避免 checksum 不匹配
 - 保持 `V1__init_database.sql` 的原有内容不变
 - `failed_trade` 表的删除通过 V16 migration 处理
 - 确保已有数据库的 migration checksum 保持一致
 ### 修复前端编译错误
 - 修复 `PositionList.tsx` 中引用不存在的 `bestBid` 属性导致的编译错误
 - 使用 `currentPrice` 替代 `bestBid`，确保前端代码可以正常编译
 ## 📚 文档更新
 - 新增智能资金分析文档（`docs/zh/smart-money-analysis.md`）
 - 详细说明智能资金分析功能的使用方法和策略
 ## 🔧 技术改进
 - 优化 `RetrofitFactory`，实现客户端实例缓存和复用
 - 优化 `CopyOrderTrackingService`，移除失败交易相关逻辑
 - 优化 `OrderStatusUpdateService`，增强订单状态更新功能
 - 优化 `TelegramNotificationService`，改进通知逻辑
 - 优化 `PositionCheckService`，简化代码结构
 - 优化 `PolymarketClobService`，改进 API 调用逻辑
 ## 📦 数据库变更
 - 删除 `failed_trade` 表（Migration: V16）
 ## 🔗 相关链接
 - **GitHub Release**: https://github.com/WrBug/PolyHermes/releases/tag/v1.1.2
 - **完整更新日志**: https://github.com/WrBug/PolyHermes/compare/v1.1.1...v1.1.2
 - **Docker Hub**: https://hub.docker.com/r/wrbug/polyhermes
 ## 📊 统计信息
 - **文件变更**: 29 个文件
 - **代码变更**: +1597 行 / -678 行
 - **主要提交**: 8 个提交
 ## ⚠️ 重要提醒
 **请务必使用官方 Docker 镜像源，避免财产损失！**
 ### ✅ 官方 Docker Hub 镜像
 **官方镜像地址**：`wrbug/polyhermes`
 ```bash
 # ✅ 正确：使用官方镜像
 docker pull wrbug/polyhermes:v1.1.2
 # ❌ 错误：不要使用其他来源的镜像
 # 任何非官方来源的镜像都可能包含恶意代码，导致您的私钥和资产被盗
 ```
 ### 🔗 官方渠道
 请通过以下**唯一官方渠道**获取 PolyHermes：
 * **GitHub 仓库**：https://github.com/WrBug/PolyHermes
 * **Twitter**：@polyhermes
 * **Telegram 群组**：https://t.me/polyhermes
 ---
 **⭐ 如果这个项目对您有帮助，请给个 Star 支持一下！**
 ---
 # v1.1.1
 ## 🚀 主要功能
 ### 🔗 链上 WebSocket 监听优化
 - 创建 `UnifiedOnChainWsService` 统一管理 WebSocket 连接，所有服务共享同一个连接
 - 创建 `OnChainWsUtils` 工具类，提取公共的链上 WebSocket 相关功能
 - 创建 `AccountOnChainMonitorService` 监听账户链上卖出和赎回事件
 - 优化 `OnChainWsService`，复用公共代码，减少代码重复
 - 支持通过链上 WebSocket 实时监听账户的卖出和赎回交易，自动更新订单状态
 ### 📊 市场状态查询优化
 - 优化市场结算状态查询，优先使用链上查询 `ConditionalTokens.getCondition`
 - 如果链上查询失败，自动降级到 Gamma API 查询
 - 提供更实时和准确的市场结算结果
 ### 🔕 自动订单通知优化
 - 自动生成的订单（AUTO_、AUTO_FIFO_、AUTO_WS_ 前缀）不再发送 Telegram 通知
 - 优化 `OrderStatusUpdateService`，跳过自动生成订单的通知处理
 - 减少不必要的通知，提升用户体验
 ## 🐛 Bug 修复
 ### 修复移动端 API 健康页面缺少数据显示
 - 移动端添加 URL 地址显示
 - 移动端添加状态文本显示（正常/异常/未配置）
 - 移动端添加消息/状态信息显示
 - 移动端和桌面端显示信息保持一致
 ## 🔧 功能优化
 ### 优化 Telegram 推送消息格式
 - 添加价格和数量截位处理：
  * 价格保留最多4位小数（截断，不四舍五入）
  * 数量保留最多2位小数（截断，不四舍五入）
 - 优化账户信息显示格式：
  * 有账户名和钱包地址时显示：账户名(0x123...123)
  * 只有账户名时显示账户名
  * 只有钱包地址时显示脱敏后的地址
  * 都没有时显示未知账户
 ### 配置优化
 - 移除 `polygon.rpc.url` 配置，使用 RpcNodeService 统一管理 RPC 节点
 - 删除无用的 `position.push.polling-interval` 和 `position.push.heartbeat-timeout` 配置项
 - 修正日志配置中的包名（polyhermes -> polymarketbot）
 - 更新 `ApiHealthCheckService` 直接使用 `RpcNodeService.getHttpUrl()`
 ## 📚 文档更新
 - 统一发布说明文件，使用 RELEASE.md 替代版本化文件（RELEASE_v1.0.1.md、RELEASE_v1.1.0.md）
 - 更新所有部署文档，移除 POLYGON_RPC_URL 相关说明
 - 更新所有 Docker Compose 配置文件，移除 POLYGON_RPC_URL 环境变量
 - 更新所有部署脚本，移除 POLYGON_RPC_URL 环境变量定义
 ## 🔧 技术改进
 - 重构链上 WebSocket 服务，提取公共代码到 `OnChainWsUtils`
 - 创建统一的 WebSocket 连接管理服务 `UnifiedOnChainWsService`
 - 添加链上查询市场结算结果的功能（`BlockchainService.getCondition`）
 - 添加 ABI 编码/解码工具方法（`EthereumUtils.decodeConditionResult`）
 - 优化代码结构，减少代码重复，提高可维护性
 ---
 # v1.1.0
 ## 🚀 主要功能
 ### 🔗 链上 WebSocket 实时监听
 - 实现通过 Polygon RPC `eth_subscribe` 实时监听链上交易
 - 支持监听 USDC Transfer 和 ERC1155 Transfer 事件
 - 实现并行监控策略：链上 WebSocket 和轮询同时运行，哪个数据先返回用哪个
 - 支持通过 `eth_unsubscribe` 取消单个 Leader 的订阅，无需重新连接
 - 优化 WebSocket 连接管理：只创建一个连接，没有跟单配置时自动取消
 - 跟单配置生效/失效时及时更新 WebSocket 订阅
 - 使用 Gson 替换所有 JSON 解析，提高解析稳定性
 - 添加 Mutex 保证线程安全，防止并发处理导致的数据重复
 ### 📊 RPC 节点管理
 - 实现 RPC 节点管理功能，支持添加、编辑、删除自定义 RPC 节点
 - 支持 RPC 节点启用/禁用功能，禁用的节点会被自动忽略
 - 前端添加启用/禁用开关，支持实时切换节点状态
 - 健康检查只检查启用的节点，提高检查效率
 - 节点选择时自动过滤禁用的节点
 ### 💰 卖出订单价格轮询更新
 - 添加 `price_updated` 字段到 `sell_match_record` 表，用于标记价格是否已更新
 - 创建 `OrderStatusUpdateService` 定时任务服务，每 5 秒轮询一次：
  - 更新卖出订单的实际成交价（通过 orderId 查询订单详情）
  - 清理已删除账户的订单记录
 - 支持加权平均价格计算，处理部分成交的订单
 - 添加 orderId 格式验证：非 0x 开头的直接标记为已更新，0x 开头的等待定时任务更新
 - 下单完成后不再立即查询价格，直接保存，等待定时任务更新
 ## 🐛 Bug 修复
 ### 修复跟单卖出订单的 API 凭证解密问题
 - 修复 `processSellTrade` 中 API 凭证未解密的问题，与 `processBuyTrade` 保持一致
 - 确保卖出订单能够正常使用 API 凭证进行认证
 ### 修复 SELL 订单精度问题
 - 修复 SELL 订单的 `makerAmount` 和 `takerAmount` 精度问题：
  - `makerAmount` (shares) 最多 2 位小数（符合 API 要求）
  - `takerAmount` (USDC) 最多 4 位小数（符合 API 要求）
 - 确保订单能够正常提交到 Polymarket API
 ## 📚 文档更新
 - 添加 Docker 版本更新说明（中英文）
 - 添加链上 WebSocket 监听策略文档
 - 添加跟单逻辑总结文档
 - 更新部署文档，包含详细的版本更新步骤
 ## 🔧 技术改进
 - 使用 Gson 替换 ObjectMapper，提高 JSON 解析稳定性
 - `JsonRpcResponse.result` 使用 `JsonElement` 类型，支持灵活的 JSON 结构
 - 优化 WebSocket 连接管理，减少不必要的连接
 - 添加线程安全机制，使用 Kotlin Coroutines Mutex
 - 启用 Spring 定时任务功能（`@EnableScheduling`）
 ## 📦 数据库变更
 - 新增 `price_updated` 字段到 `sell_match_record` 表（Migration: V13）
 ## 🔗 相关链接
 - **GitHub Release**: https://github.com/WrBug/PolyHermes/releases/tag/v1.1.1
 - **完整更新日志**: https://github.com/WrBug/PolyHermes/compare/v1.1.0...v1.1.1
 - **Docker Hub**: https://hub.docker.com/r/wrbug/polyhermes
 ## 📊 统计信息
 - **文件变更**: 32 个文件
 - **代码变更**: +1872 行 / -1503 行
 - **主要提交**: 7 个提交
 ## ⚠️ 重要提醒
 **请务必使用官方 Docker 镜像源，避免财产损失！**
 ### ✅ 官方 Docker Hub 镜像
 **官方镜像地址**：`wrbug/polyhermes`
 ```bash
 # ✅ 正确：使用官方镜像
 docker pull wrbug/polyhermes:v1.1.1
 # ❌ 错误：不要使用其他来源的镜像
 # 任何非官方来源的镜像都可能包含恶意代码，导致您的私钥和资产被盗
 ```
 ### 🔗 官方渠道
 请通过以下**唯一官方渠道**获取 PolyHermes：
 * **GitHub 仓库**：https://github.com/WrBug/PolyHermes
 * **Twitter**：@polyhermes
 * **Telegram 群组**：https://t.me/polyhermes
 ---
 **⭐ 如果这个项目对您有帮助，请给个 Star 支持一下！**
@@ -0,0 +1,76 @@
 ## 版本信息
 - **版本号**: v1.1.15
 - **发布日期**: 2026-01-19
 - **基础版本**: v1.1.14
 ## 改动摘要
 本次版本优化了订单详情处理逻辑，提升了系统稳定性和开发体验。
 ## 主要改动
 ### 🐛 Bug 修复
 #### 1. 优化订单详情为 null 时的处理逻辑
 - **提交**: 7385eff
 - **文件**: OrderStatusUpdateService.kt
 - **问题**: 
  - 订单详情为 null 且已发送通知超过 60 秒时，订单被直接删除
  - 导致已经正确处理并发送 TG 通知的订单被意外删除
 - **修复**:
  - 当订单详情为 null 且 notificationSent = true 超过 60 秒时，将订单状态改为 fully_matched
  - fully_matched 状态的订单会被自动过滤，不再查询详情
  - 避免已处理的订单被误删除
 ### 🧹 日志清理
 #### 2. 清理 MarketPollingService 中多余的 debug 日志
 - **提交**: d768da7, 07b4d65
 - **文件**: MarketPollingService.kt
 - **改进**:
  - 删除多余的 debug 日志输出
  - 减少冗余日志，提升日志可读性
  - 优化性能（减少日志 I/O）
 ### ✨ 新增功能
 #### 3. 添加订单详情查询工具脚本
 - **提交**: b658270
 - **新增文件**: 
  - scripts/get-order-detail.js - 订单详情查询脚本
  - scripts/package.json - 依赖配置文件
 - **功能**:
  - 快速查询 Polymarket 订单详情
  - 支持自动创建 API Key
  - 完善的错误处理和参数验证
  - 详细的订单信息输出
 ## 文件变更统计
 - **修改文件数**: 3
 - **新增文件数**: 2
 - **新增行数**: 192
 - **删除行数**: 6
 ## 技术细节
 ### 订单状态管理优化
 - 使用 fully_matched 状态标记已处理订单
 - 通过数据库查询条件自动过滤，无需额外缓存
 - 保持数据一致性和可追溯性
 ### 工具脚本特性
 - 基于 Polymarket CLOB Client v5.2.1
 - 支持 derive/create API Key 自动处理
 - 完整的参数验证和错误提示
 - 友好的命令行交互体验
 ## 升级建议
 - 无需特殊操作，直接部署即可
 - 建议验证订单处理逻辑是否正常工作
 - 可以使用新增的工具脚本进行调试
 ## 完整提交列表
 - 7385eff - 优化订单详情为null时的处理逻辑
 - d768da7 - 清理 MarketPollingService 中多余的 debug 日志
 - b658270 - 添加订单详情查询脚本
 - 07b4d65 - 清理 MarketPollingService 调试日志
@@ -0,0 +1,177 @@
 # PolyHermes v2.0.0 Release Notes
 ## 🎉 重大更新
 PolyHermes v2.0.0 是一个重要版本更新，带来了系统动态更新功能、优化的用户体验和多项技术改进。
 ---
 ## ✨ 新功能
 ### 🔄 系统动态更新（核心功能）
 **无需重启 Docker 容器即可更新系统**，大幅提升部署和维护效率。
 - ✅ **在线更新**：在 Web UI 中一键检查并应用更新，无需手动操作
 - ✅ **零停机更新**：更新过程约 30-60 秒，系统自动处理，无需重启容器
 - ✅ **自动回滚**：更新失败时自动恢复到旧版本，确保系统稳定性
 - ✅ **版本管理**：清晰显示当前版本和可用更新，支持 Pre-release 版本检测
 - ✅ **更新内容展示**：支持 Markdown 格式的更新说明，美观易读
 **技术特性**：
 - 独立的 Python Flask 更新服务（端口 9090），与主应用隔离
 - 单一更新包（tar.gz），包含前后端完整更新
 - 自动备份和版本管理
 - 管理员权限验证，确保安全性
 ### 📦 Release 管理工具
 - **自动化发布脚本** (`create-release.sh`)：
  - 自动创建 Git 标签
  - 发布 GitHub Release
  - 支持 Pre-release 标记
  - 自动拼接版本号后缀（Pre-release 自动添加 `-beta`）
  - 支持非交互模式，便于 CI/CD 集成
 ### 🎨 版本号显示优化
 - **Tag 格式显示**：版本号使用 Git Tag 格式（如 `v2.0.0-beta`）
 - **智能颜色提示**：
  - 🟡 **黄色 Tag**：有新版本可用（点击可跳转到系统更新页面）
  - 🟢 **绿色 Tag**：当前已是最新版本
 - **镂空样式**：更小巧美观的版本号标签
 - **自动检查**：系统自动检查更新，有新版本时在导航栏显示提示
 ---
 ## 🎨 UI/UX 优化
 ### 系统更新页面
 - **美化界面**：全新的渐变背景、卡片样式和图标设计
 - **Markdown 支持**：更新内容支持完整的 Markdown 渲染（标题、列表、代码块、表格等）
 - **进度显示**：美观的进度条和状态提示
 - **优化布局**：系统更新模块移至系统设置页面最上方，更易访问
 ### 版本号显示
 - 使用镂空 Tag 样式，字号 8px
 - 与标题垂直居中对齐
 - 响应式设计，完美支持移动端和桌面端
 ---
 ## 🔧 技术改进
 ### 构建系统
 - **修复 Docker 构建问题**：
  - 修复 `BUILD_IN_DOCKER=false` 时找不到前端产物的问题
  - 优化 `.dockerignore` 配置，确保外部构建产物可被使用
  - 修复 GitHub Actions 构建流程
 - **版本号注入**：
  - 修复前端构建时版本号未正确传递的问题
  - 支持在构建时注入 Git Tag 和版本信息
 - **Gradle Wrapper**：
  - 修复 GitHub Actions 构建错误
  - 正确配置 Gradle Wrapper JAR
 ### 代码质量
 - 修复 TypeScript 编译错误
 - 清理未使用的导入和组件
 - 优化代码结构
 ---
 ## 📝 新增文档
 - `docs/zh/DYNAMIC_UPDATE.md` - 动态更新技术方案文档
 - `docs/zh/DOCKER_VERSION.md` - Docker 版本管理说明
 - `docs/zh/DYNAMIC_UPDATE_CHECK.md` - 动态更新检查机制文档
 - `scripts/README_RELEASE.md` - Release 脚本使用说明
 - `scripts/CHANGELOG_TEMPLATE.md` - 更新日志模板
 ---
 ## 🔄 升级指南
 ### 从 v1.1.16 升级到 v2.0.0
 #### 方式一：使用动态更新功能（推荐）
 1. 登录系统，进入 **系统设置** → **系统更新**
 2. 点击 **检查更新**
 3. 如果有新版本，点击 **立即升级**
 4. 等待更新完成（约 30-60 秒）
 5. 页面会自动刷新，更新完成
 #### 方式二：重新部署 Docker 容器
 ```bash
 # 1. 停止当前容器
 docker-compose -f docker-compose.prod.yml down
 # 2. 拉取新版本镜像
 docker pull wrbug/polyhermes:v2.0.0
 # 3. 更新 docker-compose.prod.yml 中的镜像标签
 # image: wrbug/polyhermes:v2.0.0
 # 4. 重新启动
 docker-compose -f docker-compose.prod.yml up -d
 ```
 ### 注意事项
 - ⚠️ **数据备份**：虽然更新不会删除数据，但建议在更新前备份数据库
 - ⚠️ **权限要求**：执行动态更新需要管理员权限
 - ✅ **向后兼容**：v2.0.0 完全兼容 v1.1.16 的数据结构和配置
 ---
 ## 📊 变更统计
 - **新增文件**：17 个
 - **修改文件**：13 个
 - **代码变更**：+5251 行，-163 行
 ### 主要新增文件
 - `docker/update-service.py` - 更新服务（Python Flask）
 - `frontend/src/pages/SystemUpdate.tsx` - 系统更新页面
 - `create-release.sh` - Release 创建脚本
 - `docs/zh/DYNAMIC_UPDATE.md` - 动态更新技术文档
 ---
 ## 🐛 修复的问题
 - 修复 Docker 构建时找不到前端产物的问题
 - 修复前端构建时版本号未正确传递的问题
 - 修复 GitHub Actions 构建错误（Gradle Wrapper）
 - 修复 TypeScript 编译错误
 ---
 ## 📚 相关文档
 - [动态更新技术方案](docs/zh/DYNAMIC_UPDATE.md)
 - [Docker 版本管理](docs/zh/DOCKER_VERSION.md)
 - [部署指南](docs/zh/DEPLOYMENT.md)
 - [Release 脚本使用说明](scripts/README_RELEASE.md)
 ---
 ## 🙏 致谢
 感谢所有使用 PolyHermes 的用户和贡献者！
 ---
 **下载地址**：
 - Docker Hub: `wrbug/polyhermes:v2.0.0`
 - GitHub Releases: [v2.0.0](https://github.com/WrBug/PolyHermes/releases/tag/v2.0.0)
@@ -22,9 +22,9 @@ FROM eclipse-temurin:17-jre-jammy
 WORKDIR /app
-# 安装必要的工具
+# 安装必要的工具和时区数据
 RUN apt-get update && \
-    apt-get install -y curl && \
+    apt-get install -y curl tzdata && \
    rm -rf /var/lib/apt/lists/*
 # 从构建阶段复制 JAR 文件
@@ -41,8 +41,8 @@ EXPOSE 8000
 # 健康检查
 HEALTHCHECK --interval=30s --timeout=3s --start-period=40s --retries=3 \
-  CMD curl -f http://localhost:8000/api/health || exit 1
+  CMD curl -f http://localhost:8000/api/system/health || exit 1
-# 启动应用
+# 启动应用（自动使用系统时区）
 ENTRYPOINT ["java", "-jar", "app.jar"]
@@ -130,7 +130,7 @@ export PROXY_PORT=8888
 - 代理配置错误
 **排查步骤**:
-1. 检查 `polymarket.rtds.ws-url` 配置是否正确
+1. 检查 Polymarket RTDS WebSocket URL（现在使用代码常量 `PolymarketConstants.RTDS_WS_URL`）
 2. 检查网络连接
 3. 查看详细错误日志
@@ -68,6 +68,9 @@ dependencies {
    // Logging
    implementation("org.slf4j:slf4j-api")
    // Caffeine Cache (LRU)
    implementation("com.github.ben-manes.caffeine:caffeine:3.1.8")
    // Test
    testImplementation("org.springframework.boot:spring-boot-starter-test")
    testImplementation("org.jetbrains.kotlinx:kotlinx-coroutines-test")
@@ -154,9 +154,6 @@ SPRING_PROFILES_ACTIVE=prod
 # 服务器端口
 SERVER_PORT=8000
 # Polygon RPC
 POLYGON_RPC_URL=https://polygon-rpc.com
 # JWT 密钥（已自动生成随机值，生产环境建议修改）
 JWT_SECRET=${JWT_SECRET}
@@ -9,14 +9,16 @@ services:
    ports:
      - "${SERVER_PORT:-8000}:8000"
    environment:
      - TZ=${TZ:-Asia/Shanghai}
      - SPRING_PROFILES_ACTIVE=${SPRING_PROFILES_ACTIVE:-prod}
      - DB_URL=${DB_URL:-jdbc:mysql://mysql:3306/polyhermes?useSSL=false&serverTimezone=UTC&characterEncoding=utf8&allowPublicKeyRetrieval=true}
      - DB_USERNAME=${DB_USERNAME:-root}
      - DB_PASSWORD=${DB_PASSWORD:-}
      - SERVER_PORT=8000
      - POLYGON_RPC_URL=${POLYGON_RPC_URL:-https://polygon-rpc.com}
      - JWT_SECRET=${JWT_SECRET:-change-me-in-production}
      - ADMIN_RESET_PASSWORD_KEY=${ADMIN_RESET_PASSWORD_KEY:-change-me-in-production}
    volumes:
      - /etc/localtime:/etc/localtime:ro
    depends_on:
      mysql:
        condition: service_healthy
@@ -30,12 +32,14 @@ services:
    ports:
      - "${MYSQL_PORT:-3306}:3306"
    environment:
      - TZ=${TZ:-Asia/Shanghai}
      - MYSQL_ROOT_PASSWORD=${DB_PASSWORD:-rootpassword}
      - MYSQL_DATABASE=polyhermes
      - MYSQL_CHARACTER_SET_SERVER=utf8mb4
      - MYSQL_COLLATION_SERVER=utf8mb4_unicode_ci
    volumes:
      - mysql-data:/var/lib/mysql
      - /etc/localtime:/etc/localtime:ro
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${DB_PASSWORD:-rootpassword}"]
      interval: 10s
@@ -2,8 +2,10 @@ package com.wrbug.polymarketbot
 import org.springframework.boot.autoconfigure.SpringBootApplication
 import org.springframework.boot.runApplication
 import org.springframework.scheduling.annotation.EnableScheduling
@SpringBootApplication
@EnableScheduling
 class PolymarketBotApplication
 fun main(args: Array<String>) {
@@ -1,5 +1,6 @@
 package com.wrbug.polymarketbot.api
 import com.google.gson.JsonElement
 import retrofit2.Response
 import retrofit2.http.Body
 import retrofit2.http.POST
@@ -29,10 +30,11 @@ data class JsonRpcRequest(
 /**
 * JSON-RPC 响应
 * 使用 JsonElement 类型处理 result 字段，可以灵活处理字符串、对象、数组等类型
 */
 data class JsonRpcResponse(
    val jsonrpc: String? = null,
-    val result: String? = null,
+    val result: JsonElement? = null,  // 使用 JsonElement 类型，可以处理任意 JSON 类型
    val error: JsonRpcError? = null,
    val id: Int? = null
 )
@@ -149,6 +149,19 @@ interface PolymarketClobApi {
    @GET("/auth/derive-api-key")
    suspend fun deriveApiKey(): Response<ApiKeyResponse>
    /**
     * 获取费率
     * 文档: https://docs.polymarket.com/developers/market-makers/maker-rebates-program#1-fetch-the-fee-rate
     * 端点: GET /fee-rate
     * 
     * @param tokenId Token ID
     * @return 费率响应
     */
    @GET("/fee-rate")
    suspend fun getFeeRate(
        @Query("token_id") tokenId: String
    ): Response<FeeRateResponse>
    /**
     * 获取服务器时间
     * 端点: /time
@@ -227,7 +240,7 @@ data class CreateOrderRequest(
@Deprecated("使用 NewOrderRequest 代替")
 data class CreateOrdersBatchRequest(
-    val orders: List<CreateOrderRequest>
+    val orders: List<NewOrderRequest>
 )
 data class CancelOrdersBatchRequest(
@@ -357,6 +370,18 @@ data class ServerTimeResponse(
    val timestamp: Long
 )
 /**
 * 费率响应
 * 文档: https://docs.polymarket.com/developers/market-makers/maker-rebates-program#1-fetch-the-fee-rate
 * 
 * 注意：根据 TypeScript clob-client 源码，API 返回的字段名是 base_fee，而不是文档中的 fee_rate_bps
 * 参考: clob-client/src/client.ts:312
 */
 data class FeeRateResponse(
    @SerializedName("base_fee")
    val baseFee: Int  // 费率基点（0 表示无费率，1000 表示 10%）
 )
 /**
 * 最新价响应（从订单表获取）
 */
@@ -16,16 +16,35 @@ interface PolymarketGammaApi {
     * 根据 condition ID 列表获取市场信息
     * 文档: https://docs.polymarket.com/api-reference/markets/list-markets
     * @param conditionIds condition ID 数组（16 进制字符串，如 "0x..."）
     * @param clobTokenIds CLOB token ID 数组（用于通过 tokenId 查询市场）
     * @param includeTag 是否包含标签信息
     * @return 市场信息数组
     */
    @GET("/markets")
    suspend fun listMarkets(
        @Query("condition_ids") conditionIds: List<String>? = null,
        @Query("clob_token_ids") clobTokenIds: List<String>? = null,
        @Query("include_tag") includeTag: Boolean? = null
    ): Response<List<MarketResponse>>
 }
 /**
 * 事件响应（从 MarketResponse.events 解析）
 */
 data class EventResponse(
    val id: String? = null,
    val ticker: String? = null,
    val slug: String,
    val title: String,
    val category: String? = null,
    val active: Boolean? = null,
    val closed: Boolean? = null,
    val archived: Boolean? = null,
    val startDate: String? = null,
    val endDate: String? = null,
    val createdAt: String? = null
 )
 /**
 * 市场响应（根据 Gamma API 文档）
 */
@@ -51,6 +70,10 @@ data class MarketResponse(
    val liquidityNum: Double? = null,
    val lastTradePrice: Double? = null,
    val bestBid: Double? = null,
-    val bestAsk: Double? = null
+    val bestAsk: Double? = null,
    val events: List<EventResponse>? = null,  // 事件列表（从 events[0] 获取 slug）
    // 以下字段可能存在于响应中，但不在标准文档中
    val clobTokenIds: String? = null,  // CLOB token IDs（可能是 JSON 字符串或数组）
    val clob_token_ids: String? = null  // 下划线格式（兼容不同 API 版本）
 )
@@ -0,0 +1,26 @@
 package com.wrbug.polymarketbot.config
 import com.google.gson.Gson
 import com.google.gson.GsonBuilder
 import org.springframework.context.annotation.Bean
 import org.springframework.context.annotation.Configuration
 /**
 * Gson 配置类
 * 统一配置 Gson 实例，使用 lenient 模式允许解析格式不严格的 JSON
 */
@Configuration
 class GsonConfig {
    /**
     * 创建 Gson Bean
     * 使用 lenient 模式，允许解析格式不严格的 JSON
     */
    @Bean
    fun gson(): Gson {
        return GsonBuilder()
            .setLenient()
            .create()
    }
 }
@@ -36,20 +36,19 @@ class JwtAuthenticationInterceptor(
        handler: Any
    ): Boolean {
        val path = request.requestURI
-        val method = request.method
+
-        
+        // 只拦截 /api/** 路径
-        // 只拦截POST请求
+        if (!path.startsWith("/api/")) {
        if (method != "POST") {
            return true
        }
-        
+
        // 排除不需要鉴权的路径
        if (excludePaths.contains(path)) {
            return true
        }
-        
+
-        // 只拦截 /api/** 路径
+        // 允许 OPTIONS 请求（CORS 预检请求）
-        if (!path.startsWith("/api/")) {
+        if (request.method == "OPTIONS") {
            return true
        }
@@ -1,6 +1,6 @@
 package com.wrbug.polymarketbot.config
-import com.wrbug.polymarketbot.service.ProxyConfigService
+import com.wrbug.polymarketbot.service.system.ProxyConfigService
 import jakarta.annotation.PostConstruct
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Component
@@ -1,8 +1,9 @@
 package com.wrbug.polymarketbot.config
 import com.google.gson.Gson
 import com.wrbug.polymarketbot.api.PolymarketClobApi
 import com.wrbug.polymarketbot.constants.PolymarketConstants
 import com.wrbug.polymarketbot.util.createClient
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.context.annotation.Bean
 import org.springframework.context.annotation.Configuration
 import retrofit2.Retrofit
@@ -18,10 +19,9 @@ import retrofit2.converter.gson.GsonConverterFactory
 * - 账户 API Key 在调用时动态设置，不在此处配置
 */
@Configuration
-class RetrofitConfig {
+class RetrofitConfig(
-    
+    private val gson: Gson
-    @Value("\${polymarket.clob.base-url}")
+) {
    private lateinit var clobBaseUrl: String
    /**
     * 创建 CLOB API 客户端
@@ -35,9 +35,9 @@ class RetrofitConfig {
        val okHttpClient = createClient().build()
        return Retrofit.Builder()
-            .baseUrl(clobBaseUrl)
+            .baseUrl(PolymarketConstants.CLOB_BASE_URL)
            .client(okHttpClient)
-            .addConverterFactory(GsonConverterFactory.create())
+            .addConverterFactory(GsonConverterFactory.create(gson))
            .build()
            .create(PolymarketClobApi::class.java)
    }
@@ -21,10 +21,6 @@ class WebMvcConfig(
        // 再注册JWT认证拦截器
        registry.addInterceptor(jwtAuthenticationInterceptor)
            .addPathPatterns("/api/**")
        registry.addInterceptor(jwtAuthenticationInterceptor)
            .addPathPatterns("/api/**")
        registry.addInterceptor(jwtAuthenticationInterceptor)
            .addPathPatterns("/api/**")
    }
 }
@@ -1,6 +1,7 @@
 package com.wrbug.polymarketbot.config
 import com.wrbug.polymarketbot.repository.UserRepository
 import com.wrbug.polymarketbot.service.auth.WebSocketTicketService
 import com.wrbug.polymarketbot.util.JwtUtils
 import org.slf4j.LoggerFactory
 import org.springframework.http.server.ServerHttpRequest
@@ -11,12 +12,13 @@ import org.springframework.web.socket.server.HandshakeInterceptor
 /**
 * WebSocket 握手拦截器
- * 用于验证 JWT token
+ * 优先使用短期票据验证，其次使用 JWT token
 */
@Component
 class WebSocketAuthInterceptor(
    private val jwtUtils: JwtUtils,
-    private val userRepository: UserRepository
+    private val userRepository: UserRepository,
    private val webSocketTicketService: WebSocketTicketService
 ) : HandshakeInterceptor {
    private val logger = LoggerFactory.getLogger(WebSocketAuthInterceptor::class.java)
@@ -27,22 +29,36 @@ class WebSocketAuthInterceptor(
        wsHandler: WebSocketHandler,
        attributes: MutableMap<String, Any>
    ): Boolean {
-        // 从查询参数或请求头获取 token
+        // 优先使用票据验证（推荐方式，不暴露 JWT）
-        val token = getTokenFromRequest(request)
+        val ticket = getTicketFromRequest(request)
-        
+        if (ticket != null) {
-        if (token == null) {
+            val username = webSocketTicketService.validateAndConsumeTicket(ticket)
-            logger.warn("WebSocket 连接缺少认证令牌: ${request.uri}")
+            if (username != null) {
                attributes["username"] = username
                logger.debug("WebSocket 连接票据认证成功: username=$username")
                return true
            }
            logger.warn("WebSocket 连接票据验证失败（可能已过期或已使用）")
            response.setStatusCode(org.springframework.http.HttpStatus.UNAUTHORIZED)
            return false
        }
-        
+
        // 兼容旧方式：使用 JWT token（不推荐，但保持向后兼容）
        val token = getTokenFromRequest(request)
        if (token == null) {
            logger.warn("WebSocket 连接缺少认证令牌: ${request.uri.path}")
            response.setStatusCode(org.springframework.http.HttpStatus.UNAUTHORIZED)
            return false
        }
        // 验证 token
        if (!jwtUtils.validateToken(token)) {
-            logger.warn("WebSocket 连接 token 验证失败: ${request.uri}")
+            logger.warn("WebSocket 连接 token 验证失败")
            response.setStatusCode(org.springframework.http.HttpStatus.UNAUTHORIZED)
            return false
        }
-        
+
        // 验证tokenVersion（检查token是否因密码修改而失效）
        val username = jwtUtils.getUsernameFromToken(token)
        if (username != null) {
@@ -50,21 +66,21 @@ class WebSocketAuthInterceptor(
            if (user != null) {
                val tokenVersion = jwtUtils.getTokenVersionFromToken(token)
                if (tokenVersion == null || tokenVersion != user.tokenVersion) {
-                    logger.warn("WebSocket 连接 token 版本不匹配，token已失效: username=$username, tokenVersion=$tokenVersion, userTokenVersion=${user.tokenVersion}, uri=${request.uri}")
+                    logger.warn("WebSocket 连接 token 版本不匹配，token已失效: username=$username")
                    response.setStatusCode(org.springframework.http.HttpStatus.UNAUTHORIZED)
                    return false
                }
            }
-            
+
            // 获取用户名并存入 attributes，供后续使用
            attributes["username"] = username
-            logger.debug("WebSocket 连接认证成功: username=$username, uri=${request.uri}")
+            logger.debug("WebSocket 连接 JWT 认证成功: username=$username")
        } else {
-            logger.warn("WebSocket 连接无法获取用户名: ${request.uri}")
+            logger.warn("WebSocket 连接无法获取用户名")
            response.setStatusCode(org.springframework.http.HttpStatus.UNAUTHORIZED)
            return false
        }
-        
+
        return true
    }
@@ -78,7 +94,22 @@ class WebSocketAuthInterceptor(
    }
    /**
-     * 从请求中获取 token
+     * 从请求中获取票据
     */
    private fun getTicketFromRequest(request: ServerHttpRequest): String? {
        val queryParams = request.uri.query ?: return null
        val params = queryParams.split("&")
        for (param in params) {
            val parts = param.split("=", limit = 2)
            if (parts.size == 2 && parts[0] == "ticket") {
                return parts[1]
            }
        }
        return null
    }
    /**
     * 从请求中获取 token（兼容旧方式）
     * 支持从查询参数 token 或请求头 Authorization 获取
     */
    private fun getTokenFromRequest(request: ServerHttpRequest): String? {
@@ -93,13 +124,13 @@ class WebSocketAuthInterceptor(
                }
            }
        }
-        
+
        // 从请求头获取
        val authHeader = request.headers.getFirst("Authorization")
        if (authHeader != null && authHeader.startsWith("Bearer ")) {
            return authHeader.substring(7)
        }
-        
+
        return null
    }
 }
@@ -2,6 +2,7 @@ package com.wrbug.polymarketbot.config
 import com.wrbug.polymarketbot.websocket.PolymarketWebSocketHandler
 import com.wrbug.polymarketbot.websocket.UnifiedWebSocketHandler
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.context.annotation.Configuration
 import org.springframework.web.socket.config.annotation.EnableWebSocket
 import org.springframework.web.socket.config.annotation.WebSocketConfigurer
@@ -16,21 +17,46 @@ import org.springframework.web.socket.config.annotation.WebSocketHandlerRegistry
 class WebSocketConfig(
    private val polymarketWebSocketHandler: PolymarketWebSocketHandler,
    private val unifiedWebSocketHandler: UnifiedWebSocketHandler,
-    private val webSocketAuthInterceptor: WebSocketAuthInterceptor
+    private val webSocketAuthInterceptor: WebSocketAuthInterceptor,
    @Value("\${websocket.allowed-origins:}") private val allowedOriginsConfig: String
 ) : WebSocketConfigurer {
-    
+
    /**
     * 获取允许的 WebSocket 来源
     * 如果配置了 WEBSOCKET_ALLOWED_ORIGINS 环境变量，使用配置的域名
     * 否则使用 setAllowedOriginPatterns 允许同源访问
     */
    private fun getAllowedOrigins(): Array<String> {
        return if (allowedOriginsConfig.isNotBlank()) {
            allowedOriginsConfig.split(",").map { it.trim() }.toTypedArray()
        } else {
            emptyArray()
        }
    }
    override fun registerWebSocketHandlers(registry: WebSocketHandlerRegistry) {
        val origins = getAllowedOrigins()
        // Polymarket RTDS 转发端点（转发外部 Polymarket 实时数据流）
        // 注意：此端点不需要鉴权，因为它只是转发外部数据
-        registry.addHandler(polymarketWebSocketHandler, "/ws/polymarket")
+        val polymarketHandler = registry.addHandler(polymarketWebSocketHandler, "/ws/polymarket")
-            .setAllowedOrigins("*")  // 生产环境应该配置具体的域名
+        if (origins.isNotEmpty()) {
-        
+            polymarketHandler.setAllowedOrigins(*origins)
        } else {
            // 使用 setAllowedOriginPatterns 替代 setAllowedOrigins("*")，更安全
            polymarketHandler.setAllowedOriginPatterns("*")
        }
        // 统一 WebSocket 端点（所有推送服务统一使用此路径，通过 channel 区分）
-        // 支持的频道：position（仓位推送）、order（订单推送，待实现）等
+        // 支持的频道：position（仓位推送）、order（订单推送）等
        // 需要 JWT 鉴权
-        registry.addHandler(unifiedWebSocketHandler, "/ws")
+        val unifiedHandler = registry.addHandler(unifiedWebSocketHandler, "/ws")
-            .addInterceptors(webSocketAuthInterceptor)  // 添加鉴权拦截器
+            .addInterceptors(webSocketAuthInterceptor)
-            .setAllowedOrigins("*")  // 生产环境应该配置具体的域名
+        if (origins.isNotEmpty()) {
            unifiedHandler.setAllowedOrigins(*origins)
        } else {
            unifiedHandler.setAllowedOriginPatterns("*")
        }
    }
 }
@@ -0,0 +1,48 @@
 package com.wrbug.polymarketbot.constants
 /**
 * Polymarket API 常量
 * 集中管理所有 Polymarket API 的 URL 配置
 */
 object PolymarketConstants {
    /**
     * Polymarket CLOB API 基础 URL
     */
    const val CLOB_BASE_URL = "https://clob.polymarket.com"
    /**
     * Polymarket RTDS WebSocket URL
     * 用于订单推送服务
     */
    const val RTDS_WS_URL = "wss://ws-subscriptions-clob.polymarket.com"
    /**
     * Polymarket User Channel WebSocket URL
     * 用于跟单服务（订阅 Leader 交易）
     */
    const val USER_WS_URL = "wss://ws-live-data.polymarket.com"
    /**
     * Polymarket Activity WebSocket URL
     * 用于 Activity 全局交易流监听
     */
    const val ACTIVITY_WS_URL = "wss://ws-live-data.polymarket.com"
    /**
     * Polymarket Data API 基础 URL
     */
    const val DATA_API_BASE_URL = "https://data-api.polymarket.com"
    /**
     * Polymarket Gamma API 基础 URL
     */
    const val GAMMA_BASE_URL = "https://gamma-api.polymarket.com"
    /**
     * Builder Relayer API URL
     * 用于 Gasless 交易
     */
    const val BUILDER_RELAYER_URL = "https://relayer-v2.polymarket.com/"
 }
@@ -1,8 +1,8 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.accounts
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.AccountService
+import com.wrbug.polymarketbot.service.accounts.AccountService
 import com.wrbug.polymarketbot.util.toSafeBigDecimal
 import kotlinx.coroutines.runBlocking
 import org.slf4j.LoggerFactory
@@ -15,7 +15,7 @@ import java.math.BigDecimal
 * 账户管理控制器
 */
@RestController
-@RequestMapping("/api/copy-trading/accounts")
+@RequestMapping("/api/accounts")
 class AccountController(
    private val accountService: AccountService,
    private val messageSource: MessageSource
@@ -1,8 +1,8 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.announcement
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.AnnouncementService
+import com.wrbug.polymarketbot.service.announcement.AnnouncementService
 import kotlinx.coroutines.runBlocking
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
@@ -1,8 +1,10 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.auth
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.AuthService
+import com.wrbug.polymarketbot.repository.UserRepository
 import com.wrbug.polymarketbot.service.auth.AuthService
 import com.wrbug.polymarketbot.service.auth.WebSocketTicketService
 import jakarta.servlet.http.HttpServletRequest
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
@@ -16,7 +18,9 @@ import org.springframework.web.bind.annotation.*
@RequestMapping("/api/auth")
 class AuthController(
    private val authService: AuthService,
-    private val messageSource: MessageSource
+    private val messageSource: MessageSource,
    private val webSocketTicketService: WebSocketTicketService,
    private val userRepository: UserRepository
 ) {
    private val logger = LoggerFactory.getLogger(AuthController::class.java)
@@ -25,7 +29,10 @@ class AuthController(
     * 登录接口
     */
    @PostMapping("/login")
-    fun login(@RequestBody request: LoginRequest): ResponseEntity<ApiResponse<LoginResponse>> {
+    fun login(
        @RequestBody request: LoginRequest,
        httpRequest: HttpServletRequest
    ): ResponseEntity<ApiResponse<LoginResponse>> {
        return try {
            if (request.username.isBlank()) {
                return ResponseEntity.ok(ApiResponse.error(ErrorCode.PARAM_EMPTY, "用户名不能为空", messageSource))
@@ -33,15 +40,19 @@ class AuthController(
            if (request.password.isBlank()) {
                return ResponseEntity.ok(ApiResponse.error(ErrorCode.PARAM_EMPTY, "密码不能为空", messageSource))
            }
-            
+
-            val result = authService.login(request.username, request.password)
+            val ipAddress = getClientIpAddress(httpRequest)
            val result = authService.login(request.username, request.password, ipAddress)
            result.fold(
                onSuccess = { loginResponse ->
                    ResponseEntity.ok(ApiResponse.success(loginResponse))
                },
                onFailure = { e ->
                    logger.error("登录失败: ${e.message}", e)
                    when (e) {
                        is IllegalStateException -> {
                            // 限速或锁定错误
                            ResponseEntity.ok(ApiResponse.error(ErrorCode.AUTH_ERROR, e.message ?: "登录失败", messageSource))
                        }
                        is IllegalArgumentException -> {
                            if (e.message == ErrorCode.AUTH_USERNAME_OR_PASSWORD_ERROR.message) {
                                ResponseEntity.ok(ApiResponse.error(ErrorCode.AUTH_USERNAME_OR_PASSWORD_ERROR, messageSource = messageSource))
@@ -49,15 +60,36 @@ class AuthController(
                                ResponseEntity.ok(ApiResponse.error(ErrorCode.PARAM_ERROR, e.message, messageSource))
                            }
                        }
-                        else -> ResponseEntity.ok(ApiResponse.error(ErrorCode.AUTH_ERROR, "登录失败: ${e.message}", messageSource))
+                        else -> ResponseEntity.ok(ApiResponse.error(ErrorCode.AUTH_ERROR, "登录失败", messageSource))
                    }
                }
            )
        } catch (e: Exception) {
            logger.error("登录异常: ${e.message}", e)
-            ResponseEntity.ok(ApiResponse.error(ErrorCode.AUTH_ERROR, "登录失败: ${e.message}", messageSource))
+            ResponseEntity.ok(ApiResponse.error(ErrorCode.AUTH_ERROR, "登录失败", messageSource))
        }
    }
    /**
     * 获取客户端IP地址
     */
    private fun getClientIpAddress(request: HttpServletRequest): String {
        var ip = request.getHeader("X-Forwarded-For")
        if (ip.isNullOrBlank() || "unknown".equals(ip, ignoreCase = true)) {
            ip = request.getHeader("X-Real-IP")
        }
        if (ip.isNullOrBlank() || "unknown".equals(ip, ignoreCase = true)) {
            ip = request.getHeader("Proxy-Client-IP")
        }
        if (ip.isNullOrBlank() || "unknown".equals(ip, ignoreCase = true)) {
            ip = request.remoteAddr
        }
        // 处理多个IP的情况
        if (ip.contains(",")) {
            ip = ip.split(",")[0].trim()
        }
        return ip
    }
    /**
     * 重置密码接口
@@ -132,5 +164,54 @@ class AuthController(
            ResponseEntity.ok(ApiResponse.error(ErrorCode.SERVER_ERROR, "检查首次使用失败: ${e.message}", messageSource))
        }
    }
    /**
     * 获取 WebSocket 连接票据
     * 返回一个短期有效（30秒）的一次性票据，用于 WebSocket 连接认证
     * 避免在 WebSocket URL 中暴露 JWT
     */
    @PostMapping("/ws-ticket")
    fun getWebSocketTicket(httpRequest: HttpServletRequest): ResponseEntity<ApiResponse<WebSocketTicketResponse>> {
        return try {
            // 从请求属性中获取用户名（由 JWT 拦截器设置）
            val username = httpRequest.getAttribute("username") as? String
            if (username == null) {
                return ResponseEntity.ok(ApiResponse.error(ErrorCode.AUTH_ERROR, "未认证", messageSource))
            }
            val ticket = webSocketTicketService.generateTicket(username)
            ResponseEntity.ok(ApiResponse.success(WebSocketTicketResponse(ticket = ticket)))
        } catch (e: Exception) {
            logger.error("获取 WebSocket 票据异常: ${e.message}", e)
            ResponseEntity.ok(ApiResponse.error(ErrorCode.SERVER_ERROR, "获取票据失败", messageSource))
        }
    }
    /**
     * 验证当前用户权限
     * 用于动态更新服务验证管理员权限
     * 管理员权限判断：是否为默认账户（isDefault == true）
     */
    @GetMapping("/verify")
    fun verify(httpRequest: HttpServletRequest): ResponseEntity<ApiResponse<Unit>> {
        return try {
            // 从请求属性中获取用户名（由 JWT 拦截器设置）
            val username = httpRequest.getAttribute("username") as? String
            if (username == null) {
                return ResponseEntity.status(401).body(ApiResponse.error(ErrorCode.AUTH_ERROR, "未认证", messageSource))
            }
            // 检查是否为默认账户（管理员）
            val user = userRepository.findByUsername(username)
            if (user == null || !user.isDefault) {
                return ResponseEntity.status(403).body(ApiResponse.error(ErrorCode.AUTH_ERROR, "需要管理员权限", messageSource))
            }
            ResponseEntity.ok(ApiResponse.success(Unit))
        } catch (e: Exception) {
            logger.error("验证权限异常: ${e.message}", e)
            ResponseEntity.status(500).body(ApiResponse.error(ErrorCode.SERVER_ERROR, "验证失败", messageSource))
        }
    }
 }
@@ -1,9 +1,9 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.copytrading.configs
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.CopyTradingService
+import com.wrbug.polymarketbot.service.copytrading.configs.CopyTradingService
-import com.wrbug.polymarketbot.service.FilteredOrderService
+import com.wrbug.polymarketbot.service.copytrading.configs.FilteredOrderService
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
 import org.springframework.http.ResponseEntity
@@ -13,7 +13,7 @@ import org.springframework.web.bind.annotation.*
 * 跟单配置管理控制器（钱包-模板关联）
 */
@RestController
-@RequestMapping("/api/copy-trading")
+@RequestMapping("/api/copy-trading/configs")
 class CopyTradingController(
    private val copyTradingService: CopyTradingService,
    private val filteredOrderService: FilteredOrderService,
@@ -1,8 +1,8 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.copytrading.leaders
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.LeaderService
+import com.wrbug.polymarketbot.service.copytrading.leaders.LeaderService
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
 import org.springframework.http.ResponseEntity
@@ -1,8 +1,8 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.copytrading.statistics
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.CopyTradingStatisticsService
+import com.wrbug.polymarketbot.service.copytrading.statistics.CopyTradingStatisticsService
 import kotlinx.coroutines.runBlocking
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
@@ -200,5 +200,51 @@ class CopyOrderTrackingController(
            ResponseEntity.ok(ApiResponse.error(ErrorCode.SERVER_ORDER_TRACKING_LIST_FETCH_FAILED, e.message, messageSource))
        }
    }
    /**
     * 查询按市场分组的订单列表（买入/卖出）
     * POST /api/copy-trading/orders/grouped-by-market
     */
    @PostMapping("/grouped-by-market")
    fun getOrderListGroupedByMarket(@RequestBody request: MarketGroupedOrdersRequest): ResponseEntity<ApiResponse<MarketGroupedOrdersResponse>> {
        return try {
            if (request.copyTradingId <= 0) {
                return ResponseEntity.ok(ApiResponse.error(ErrorCode.PARAM_COPY_TRADING_ID_INVALID, messageSource = messageSource))
            }
            if (request.type.isBlank()) {
                return ResponseEntity.ok(ApiResponse.error(ErrorCode.PARAM_EMPTY, "订单类型不能为空", messageSource))
            }
            val validTypes = listOf("buy", "sell")
            if (!validTypes.contains(request.type.lowercase())) {
                return ResponseEntity.ok(ApiResponse.error(ErrorCode.PARAM_ERROR, "订单类型必须是 buy 或 sell", messageSource))
            }
            val result: Result<MarketGroupedOrdersResponse> = runBlocking {
                when (request.type.lowercase()) {
                    "buy" -> statisticsService.getBuyOrderListGroupedByMarket(request)
                    "sell" -> statisticsService.getSellOrderListGroupedByMarket(request)
                    else -> Result.failure(IllegalArgumentException("不支持的订单类型: ${request.type}"))
                }
            }
            result.fold(
                onSuccess = { response: MarketGroupedOrdersResponse ->
                    ResponseEntity.ok(ApiResponse.success(response))
                },
                onFailure = { e: Throwable ->
                    logger.error("查询按市场分组的订单列表失败: copyTradingId=${request.copyTradingId}, type=${request.type}", e)
                    when (e) {
                        is IllegalArgumentException -> ResponseEntity.ok(ApiResponse.error(ErrorCode.PARAM_ERROR, e.message, messageSource))
                        else -> ResponseEntity.ok(ApiResponse.error(ErrorCode.SERVER_ORDER_TRACKING_LIST_FETCH_FAILED, e.message, messageSource))
                    }
                }
            )
        } catch (e: Exception) {
            logger.error("查询按市场分组的订单列表异常: copyTradingId=${request.copyTradingId}, type=${request.type}", e)
            ResponseEntity.ok(ApiResponse.error(ErrorCode.SERVER_ORDER_TRACKING_LIST_FETCH_FAILED, e.message, messageSource))
        }
    }
 }
@@ -1,8 +1,8 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.copytrading.templates
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.CopyTradingTemplateService
+import com.wrbug.polymarketbot.service.copytrading.templates.CopyTradingTemplateService
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
 import org.springframework.http.ResponseEntity
@@ -1,11 +1,13 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.markets
 import com.wrbug.polymarketbot.api.LatestPriceResponse
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.AccountService
+import com.wrbug.polymarketbot.service.accounts.AccountService
-import com.wrbug.polymarketbot.service.PolymarketClobService
+import com.wrbug.polymarketbot.service.common.MarketPriceService
 import com.wrbug.polymarketbot.service.common.PolymarketClobService
 import kotlinx.coroutines.runBlocking
 import java.math.BigDecimal
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
 import org.springframework.http.ResponseEntity
@@ -16,18 +18,20 @@ import org.springframework.web.bind.annotation.*
 * 提供市场相关的数据查询接口（价格、订单簿等）
 */
@RestController
-@RequestMapping("/api/copy-trading/markets")
+@RequestMapping("/api/markets")
 class MarketController(
    private val accountService: AccountService,
    private val clobService: PolymarketClobService,
    private val marketPriceService: MarketPriceService,
    private val messageSource: MessageSource
 ) {
    private val logger = LoggerFactory.getLogger(MarketController::class.java)
    /**
-     * 获取市场价格（通过 Gamma API）
+     * 获取市场价格
-     * 使用 Gamma API 获取价格信息，因为 Gamma API 支持 condition_ids 参数
+     * 使用 MarketPriceService 获取当前市场价格（支持多数据源降级）
     * 返回当前价格，前端接收后自行填充到 bestBid 字段
     */
    @PostMapping("/price")
    fun getMarketPrice(@RequestBody request: MarketPriceRequest): ResponseEntity<ApiResponse<MarketPriceResponse>> {
@@ -36,16 +40,16 @@ class MarketController(
                return ResponseEntity.ok(ApiResponse.error(ErrorCode.PARAM_MARKET_ID_EMPTY, messageSource = messageSource))
            }
-            val result = runBlocking { accountService.getMarketPrice(request.marketId, request.outcomeIndex) }
+            val outcomeIndex = request.outcomeIndex ?: 0
-            result.fold(
+            val price = runBlocking { 
-                onSuccess = { response ->
+                marketPriceService.getCurrentMarketPrice(request.marketId, outcomeIndex) 
-                    ResponseEntity.ok(ApiResponse.success(response))
+            }
-                },
+            
-                onFailure = { e ->
+            val response = MarketPriceResponse(
-                    logger.error("获取市场价格失败: ${e.message}", e)
+                marketId = request.marketId,
-                    ResponseEntity.ok(ApiResponse.error(ErrorCode.SERVER_MARKET_PRICE_FETCH_FAILED, e.message, messageSource))
+                currentPrice = price.toString()
                }
            )
            ResponseEntity.ok(ApiResponse.success(response))
        } catch (e: Exception) {
            logger.error("获取市场价格异常: ${e.message}", e)
            ResponseEntity.ok(ApiResponse.error(ErrorCode.SERVER_MARKET_PRICE_FETCH_FAILED, e.message, messageSource))
@@ -1,4 +1,4 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.system
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.GetMapping
@@ -11,7 +11,7 @@ import java.util.*
 * 用于 Docker 健康检查和监控
 */
@RestController
-@RequestMapping("/api/health")
+@RequestMapping("/api/system/health")
 class HealthController {
    @GetMapping
@@ -1,9 +1,9 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.system
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.NotificationConfigService
+import com.wrbug.polymarketbot.service.system.NotificationConfigService
-import com.wrbug.polymarketbot.service.TelegramNotificationService
+import com.wrbug.polymarketbot.service.system.TelegramNotificationService
 import kotlinx.coroutines.runBlocking
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
@@ -14,7 +14,7 @@ import org.springframework.web.bind.annotation.*
 * 消息推送配置控制器
 */
@RestController
-@RequestMapping("/api/notifications")
+@RequestMapping("/api/system/notifications")
 class NotificationController(
    private val notificationConfigService: NotificationConfigService,
    private val telegramNotificationService: TelegramNotificationService,
@@ -1,9 +1,9 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.system
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.ApiHealthCheckService
+import com.wrbug.polymarketbot.service.system.ApiHealthCheckService
-import com.wrbug.polymarketbot.service.ProxyConfigService
+import com.wrbug.polymarketbot.service.system.ProxyConfigService
 import jakarta.servlet.http.HttpServletRequest
 import kotlinx.coroutines.runBlocking
 import org.slf4j.LoggerFactory
@@ -15,7 +15,7 @@ import org.springframework.web.bind.annotation.*
 * 代理配置控制器
 */
@RestController
-@RequestMapping("/api/proxy-config")
+@RequestMapping("/api/system/proxy")
 class ProxyConfigController(
    private val proxyConfigService: ProxyConfigService,
    private val apiHealthCheckService: ApiHealthCheckService,
@@ -0,0 +1,366 @@
 package com.wrbug.polymarketbot.controller.system
 import com.wrbug.polymarketbot.dto.ApiResponse
 import com.wrbug.polymarketbot.entity.RpcNodeConfig
 import com.wrbug.polymarketbot.enums.ErrorCode
 import com.wrbug.polymarketbot.service.system.AddRpcNodeRequest
 import com.wrbug.polymarketbot.service.system.NodeCheckResult
 import com.wrbug.polymarketbot.service.system.RpcNodeService
 import com.wrbug.polymarketbot.service.system.UpdateRpcNodeRequest
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
 import org.springframework.http.ResponseEntity
 import org.springframework.web.bind.annotation.*
 /**
 * RPC 节点管理控制器
 */
@RestController
@RequestMapping("/api/system/rpc-nodes")
 class RpcNodeController(
    private val rpcNodeService: RpcNodeService,
    private val messageSource: MessageSource
 ) {
    private val logger = LoggerFactory.getLogger(RpcNodeController::class.java)
    /**
     * 获取所有节点列表
     */
    @PostMapping("/list")
    fun getAllNodes(@RequestBody request: Map<String, Any>?): ResponseEntity<ApiResponse<List<RpcNodeConfigDto>>> {
        return try {
            val nodes = rpcNodeService.getAllNodes()
            val dtos = nodes.map { it.toDto() }
            ResponseEntity.ok(ApiResponse.success(dtos))
        } catch (e: Exception) {
            logger.error("获取 RPC 节点列表失败: ${e.message}", e)
            ResponseEntity.ok(ApiResponse.error(
                ErrorCode.SERVER_ERROR,
                customMsg = "获取节点列表失败：${e.message}",
                messageSource = messageSource
            ))
        }
    }
    /**
     * 添加节点
     */
    @PostMapping("/add")
    fun addNode(@RequestBody request: AddRpcNodeRequest): ResponseEntity<ApiResponse<RpcNodeConfigDto>> {
        return try {
            if (request.providerType.isBlank()) {
                return ResponseEntity.ok(ApiResponse.paramError("服务商类型不能为空"))
            }
            if (request.name.isBlank()) {
                return ResponseEntity.ok(ApiResponse.paramError("节点名称不能为空"))
            }
            val result = rpcNodeService.addNode(request)
            result.fold(
                onSuccess = { node ->
                    ResponseEntity.ok(ApiResponse.success(node.toDto()))
                },
                onFailure = { e ->
                    logger.error("添加 RPC 节点失败: ${e.message}", e)
                    ResponseEntity.ok(ApiResponse.error(
                        ErrorCode.SERVER_ERROR,
                        customMsg = "添加节点失败：${e.message}",
                        messageSource = messageSource
                    ))
                }
            )
        } catch (e: Exception) {
            logger.error("添加 RPC 节点异常: ${e.message}", e)
            ResponseEntity.ok(ApiResponse.error(
                ErrorCode.SERVER_ERROR,
                customMsg = "添加节点失败：${e.message}",
                messageSource = messageSource
            ))
        }
    }
    /**
     * 更新节点
     */
    @PostMapping("/update")
    fun updateNode(@RequestBody request: UpdateRpcNodeRequest): ResponseEntity<ApiResponse<RpcNodeConfigDto>> {
        return try {
            val result = rpcNodeService.updateNode(request)
            result.fold(
                onSuccess = { node ->
                    ResponseEntity.ok(ApiResponse.success(node.toDto()))
                },
                onFailure = { e ->
                    logger.error("更新 RPC 节点失败: ${e.message}", e)
                    ResponseEntity.ok(ApiResponse.error(
                        ErrorCode.SERVER_ERROR,
                        customMsg = "更新节点失败：${e.message}",
                        messageSource = messageSource
                    ))
                }
            )
        } catch (e: Exception) {
            logger.error("更新 RPC 节点异常: ${e.message}", e)
            ResponseEntity.ok(ApiResponse.error(
                ErrorCode.SERVER_ERROR,
                customMsg = "更新节点失败：${e.message}",
                messageSource = messageSource
            ))
        }
    }
    /**
     * 删除节点
     */
    @PostMapping("/delete")
    fun deleteNode(@RequestBody request: DeleteRpcNodeRequest): ResponseEntity<ApiResponse<Unit>> {
        return try {
            val result = rpcNodeService.deleteNode(request.id)
            result.fold(
                onSuccess = {
                    ResponseEntity.ok(ApiResponse.success(Unit))
                },
                onFailure = { e ->
                    logger.error("删除 RPC 节点失败: ${e.message}", e)
                    ResponseEntity.ok(ApiResponse.error(
                        ErrorCode.SERVER_ERROR,
                        customMsg = "删除节点失败：${e.message}",
                        messageSource = messageSource
                    ))
                }
            )
        } catch (e: Exception) {
            logger.error("删除 RPC 节点异常: ${e.message}", e)
            ResponseEntity.ok(ApiResponse.error(
                ErrorCode.SERVER_ERROR,
                customMsg = "删除节点失败：${e.message}",
                messageSource = messageSource
            ))
        }
    }
    /**
     * 更新节点优先级
     */
    @PostMapping("/update-priority")
    fun updatePriority(@RequestBody request: UpdatePriorityRequest): ResponseEntity<ApiResponse<Unit>> {
        return try {
            val result = rpcNodeService.updatePriority(request.id, request.priority)
            result.fold(
                onSuccess = {
                    ResponseEntity.ok(ApiResponse.success(Unit))
                },
                onFailure = { e ->
                    logger.error("更新节点优先级失败: ${e.message}", e)
                    ResponseEntity.ok(ApiResponse.error(
                        ErrorCode.SERVER_ERROR,
                        customMsg = "更新优先级失败：${e.message}",
                        messageSource = messageSource
                    ))
                }
            )
        } catch (e: Exception) {
            logger.error("更新节点优先级异常: ${e.message}", e)
            ResponseEntity.ok(ApiResponse.error(
                ErrorCode.SERVER_ERROR,
                customMsg = "更新优先级失败：${e.message}",
                messageSource = messageSource
            ))
        }
    }
    /**
     * 检查节点健康状态
     */
    @PostMapping("/check-health")
    fun checkHealth(@RequestBody request: CheckHealthRequest): ResponseEntity<ApiResponse<Any>> {
        return try {
            if (request.id != null) {
                // 检查单个节点
                val result = rpcNodeService.checkNodeHealth(request.id)
                result.fold(
                    onSuccess = { checkResult ->
                        ResponseEntity.ok(ApiResponse.success(checkResult.toDto()))
                    },
                    onFailure = { e ->
                        logger.error("检查节点健康状态失败: ${e.message}", e)
                        ResponseEntity.ok(ApiResponse.error(
                            ErrorCode.SERVER_ERROR,
                            customMsg = "检查节点失败：${e.message}",
                            messageSource = messageSource
                        ))
                    }
                )
            } else {
                // 批量检查所有节点
                val result = rpcNodeService.checkAllNodesHealth()
                result.fold(
                    onSuccess = { checkResults ->
                        val dtos = checkResults.mapValues { it.value.toDto() }
                        ResponseEntity.ok(ApiResponse.success(dtos))
                    },
                    onFailure = { e ->
                        logger.error("批量检查节点健康状态失败: ${e.message}", e)
                        ResponseEntity.ok(ApiResponse.error(
                            ErrorCode.SERVER_ERROR,
                            customMsg = "批量检查节点失败：${e.message}",
                            messageSource = messageSource
                        ))
                    }
                )
            }
        } catch (e: Exception) {
            logger.error("检查节点健康状态异常: ${e.message}", e)
            ResponseEntity.ok(ApiResponse.error(
                ErrorCode.SERVER_ERROR,
                customMsg = "检查节点失败：${e.message}",
                messageSource = messageSource
            ))
        }
    }
    /**
     * 校验节点（添加前）
     */
    @PostMapping("/validate")
    fun validateNode(@RequestBody request: AddRpcNodeRequest): ResponseEntity<ApiResponse<ValidateNodeResponse>> {
        return try {
            if (request.providerType.isBlank()) {
                return ResponseEntity.ok(ApiResponse.paramError("服务商类型不能为空"))
            }
            if (request.name.isBlank()) {
                return ResponseEntity.ok(ApiResponse.paramError("节点名称不能为空"))
            }
            // 临时创建节点配置以进行验证（不保存到数据库）
            // 这里直接复用 addNode 的部分逻辑，但只进行校验
            val result = rpcNodeService.addNode(request)
            result.fold(
                onSuccess = { node ->
                    // 添加成功后立即删除（这只是为了校验）
                    rpcNodeService.deleteNode(node.id!!)
                    ResponseEntity.ok(ApiResponse.success(ValidateNodeResponse(
                        valid = true,
                        message = "节点可用",
                        responseTimeMs = node.responseTimeMs
                    )))
                },
                onFailure = { e ->
                    ResponseEntity.ok(ApiResponse.success(ValidateNodeResponse(
                        valid = false,
                        message = e.message ?: "节点验证失败",
                        responseTimeMs = null
                    )))
                }
            )
        } catch (e: Exception) {
            logger.error("验证节点异常: ${e.message}", e)
            ResponseEntity.ok(ApiResponse.success(ValidateNodeResponse(
                valid = false,
                message = e.message ?: "节点验证失败",
                responseTimeMs = null
            )))
        }
    }
 }
 /**
 * RPC 节点配置 DTO
 */
 data class RpcNodeConfigDto(
    val id: Long?,
    val providerType: String,
    val name: String,
    val httpUrl: String,
    val wsUrl: String?,
    val apiKeyMasked: String?,  // 脱敏后的 API Key
    val enabled: Boolean,
    val priority: Int,
    val lastCheckTime: Long?,
    val lastCheckStatus: String?,
    val responseTimeMs: Int?,
    val createdAt: Long,
    val updatedAt: Long
 )
 /**
 * 节点检查结果 DTO
 */
 data class NodeCheckResultDto(
    val status: String,
    val message: String,
    val checkTime: Long,
    val responseTimeMs: Int?,
    val blockNumber: String?
 )
 /**
 * 验证节点响应
 */
 data class ValidateNodeResponse(
    val valid: Boolean,
    val message: String,
    val responseTimeMs: Int?
 )
 /**
 * 删除节点请求
 */
 data class DeleteRpcNodeRequest(
    val id: Long
 )
 /**
 * 更新优先级请求
 */
 data class UpdatePriorityRequest(
    val id: Long,
    val priority: Int
 )
 /**
 * 检查健康状态请求
 */
 data class CheckHealthRequest(
    val id: Long? = null  // 如果为 null，则检查所有节点
 )
 /**
 * 扩展函数：将 RpcNodeConfig 转换为 DTO
 */
 private fun RpcNodeConfig.toDto(): RpcNodeConfigDto {
    return RpcNodeConfigDto(
        id = id,
        providerType = providerType,
        name = name,
        httpUrl = httpUrl,
        wsUrl = wsUrl,
        apiKeyMasked = apiKey?.let { "***" },  // 脱敏显示
        enabled = enabled,
        priority = priority,
        lastCheckTime = lastCheckTime,
        lastCheckStatus = lastCheckStatus,
        responseTimeMs = responseTimeMs,
        createdAt = createdAt,
        updatedAt = updatedAt
    )
 }
 /**
 * 扩展函数：将 NodeCheckResult 转换为 DTO
 */
 private fun NodeCheckResult.toDto(): NodeCheckResultDto {
    return NodeCheckResultDto(
        status = status.name,
        message = message,
        checkTime = checkTime,
        responseTimeMs = responseTimeMs,
        blockNumber = blockNumber
    )
 }
@@ -1,9 +1,9 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.system
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.SystemConfigService
+import com.wrbug.polymarketbot.service.system.SystemConfigService
-import com.wrbug.polymarketbot.service.RelayClientService
+import com.wrbug.polymarketbot.service.system.RelayClientService
 import kotlinx.coroutines.runBlocking
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
@@ -1,8 +1,8 @@
-package com.wrbug.polymarketbot.controller
+package com.wrbug.polymarketbot.controller.system
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.enums.ErrorCode
-import com.wrbug.polymarketbot.service.UserService
+import com.wrbug.polymarketbot.service.system.UserService
 import jakarta.servlet.http.HttpServletRequest
 import org.slf4j.LoggerFactory
 import org.springframework.context.MessageSource
@@ -13,7 +13,7 @@ import org.springframework.web.bind.annotation.*
 * 用户管理控制器
 */
@RestController
-@RequestMapping("/api/users")
+@RequestMapping("/api/system/users")
 class UserController(
    private val userService: UserService,
    private val messageSource: MessageSource
@@ -7,7 +7,8 @@ data class AccountImportRequest(
    val privateKey: String,  // 私钥（前端加密后传输）
    val walletAddress: String,  // 钱包地址（前端从私钥推导，用于验证）
    val accountName: String? = null,
-    val isEnabled: Boolean = true  // 是否启用（用于订单推送等功能的开关）
+    val isEnabled: Boolean = true,  // 是否启用（用于订单推送等功能的开关）
    val walletType: String = "magic"  // 钱包类型：magic（邮箱/OAuth登录）或 safe（MetaMask浏览器钱包）
 )
 /**
@@ -36,6 +37,9 @@ data class SystemConfigDto(
    val builderApiKeyConfigured: Boolean,  // Builder API Key 是否已配置
    val builderSecretConfigured: Boolean,  // Builder Secret 是否已配置
    val builderPassphraseConfigured: Boolean,  // Builder Passphrase 是否已配置
    val builderApiKeyDisplay: String? = null,  // Builder API Key 显示值（部分显示，用于前端展示）
    val builderSecretDisplay: String? = null,  // Builder Secret 显示值（部分显示，用于前端展示）
    val builderPassphraseDisplay: String? = null,  // Builder Passphrase 显示值（部分显示，用于前端展示）
    val autoRedeemEnabled: Boolean = true  // 自动赎回（系统级别配置，默认开启）
 )
@@ -69,6 +73,7 @@ data class AccountDto(
    val proxyAddress: String,  // Polymarket 代理钱包地址
    val accountName: String?,
    val isEnabled: Boolean,  // 是否启用（用于订单推送等功能的开关）
    val walletType: String = "magic",  // 钱包类型：magic（邮箱/OAuth登录）或 safe（MetaMask浏览器钱包）
    val apiKeyConfigured: Boolean,  // API Key 是否已配置（不返回实际 Key）
    val apiSecretConfigured: Boolean,  // API Secret 是否已配置
    val apiPassphraseConfigured: Boolean,  // API Passphrase 是否已配置
@@ -120,7 +125,8 @@ data class AccountPositionDto(
    val proxyAddress: String,
    val marketId: String,
    val marketTitle: String?,
-    val marketSlug: String?,
+    val marketSlug: String?,  // 显示用的 slug
    val eventSlug: String? = null,  // 跳转用的 slug（从 events[0].slug 获取）
    val marketIcon: String?,  // 市场图标 URL
    val side: String,  // 结果名称（如 "YES", "NO", "Pakistan" 等）
    val outcomeIndex: Int? = null,  // 结果索引（0, 1, 2...），用于计算 tokenId
@@ -192,14 +198,11 @@ data class LatestPriceRequest(
 )
 /**
- * 市场价格响应
+ * 市场当前价格响应
 */
 data class MarketPriceResponse(
    val marketId: String,
-    val lastPrice: String?,    // 最新成交价
+    val currentPrice: String   // 当前价格（通过 MarketPriceService 获取，支持多数据源降级）
    val bestBid: String?,      // 最优买价（用于卖出参考）
    val bestAsk: String?,      // 最优卖价（用于买入参考）
    val midpoint: String?      // 中间价
 )
 /**
@@ -0,0 +1,64 @@
 package com.wrbug.polymarketbot.dto
 import com.google.gson.annotations.SerializedName
 /**
 * Activity WebSocket 交易消息 DTO
 * 根据 Polymarket RTDS Activity WebSocket API 格式定义
 */
 data class ActivityTradeMessage(
    val topic: String = "",                    // "activity"
    val type: String = "",                     // "trades"
    val timestamp: Long? = null,               // 消息时间戳（可选）
    @SerializedName("connection_id")
    val connectionId: String? = null,          // 连接 ID（可选，由服务器返回）
    val payload: ActivityTradePayload = ActivityTradePayload()  // 交易数据
 )
 /**
 * Activity Trade Payload
 */
 data class ActivityTradePayload(
    val asset: String = "",                    // Token ID (用于下单)
    @SerializedName("conditionId")
    val conditionId: String = "",              // Market condition ID
    @SerializedName("eventSlug")
    val eventSlug: String? = null,             // 事件 slug
    val slug: String? = null,                  // 市场 slug
    val outcome: String? = null,               // 结果方向 (Yes/No/Up/Down)
    @SerializedName("outcomeIndex")
    val outcomeIndex: Int? = null,             // 结果索引 (0=Yes/Up, 1=No/Down) - 优先使用此字段
    val side: String = "",                     // 交易方向 (BUY/SELL)
    // price 和 size 可能是数字或字符串，使用 Any 类型，后续转换为 String
    val price: Any? = null,                    // 交易价格
    val size: Any? = null,                     // 交易数量 (shares)
    val timestamp: Any? = null,                // Unix 时间戳（可能是秒或毫秒，可能是数字或字符串）
    @SerializedName("transactionHash")
    val transactionHash: String? = null,       // 交易哈希
    val trader: ActivityTrader? = null,        // 交易者信息对象（优先）
    @SerializedName("proxyWallet")
    val proxyWallet: String? = null,           // 交易者地址（fallback，如果 trader 不存在）
    val name: String? = null                   // 交易者名称（fallback，如果 trader 不存在）
 )
 /**
 * Activity Trader 信息
 */
 data class ActivityTrader(
    val name: String? = null,             // 交易者用户名（可选）
    val address: String? = null           // 交易者钱包地址 ⭐ 关键字段
 )
@@ -14,3 +14,10 @@ data class CheckFirstUseResponse(
    val isFirstUse: Boolean
 )
 /**
 * WebSocket 票据响应
 */
 data class WebSocketTicketResponse(
    val ticket: String
 )
@@ -32,12 +32,19 @@ data class CopyTradingCreateRequest(
    // 过滤条件
    val minOrderDepth: String? = null,  // 最小订单深度（USDC金额），NULL表示不启用
    val maxSpread: String? = null,  // 最大价差（绝对价格），NULL表示不启用
    val minOrderbookDepth: String? = null,  // 最小订单簿深度（USDC金额），NULL表示不启用
    val minPrice: String? = null,  // 最低价格（可选），NULL表示不限制最低价
    val maxPrice: String? = null,  // 最高价格（可选），NULL表示不限制最高价
    // 最大仓位配置
    val maxPositionValue: String? = null,  // 最大仓位金额（USDC），NULL表示不启用
    val maxPositionCount: Int? = null,  // 最大仓位数量，NULL表示不启用
    // 关键字过滤配置
    val keywordFilterMode: String? = null,  // 关键字过滤模式：DISABLED（不启用）、WHITELIST（白名单）、BLACKLIST（黑名单）
    val keywords: List<String>? = null,  // 关键字列表，当keywordFilterMode为DISABLED时为null
    // 新增配置字段
    val configName: String? = null,  // 配置名（可选）
-    val pushFailedOrders: Boolean? = null  // 推送失败订单（可选）
+    val pushFailedOrders: Boolean? = null,  // 推送失败订单（可选）
    val pushFilteredOrders: Boolean? = null,  // 推送已过滤订单（可选）
    val maxMarketEndDate: Long? = null  // 市场截止时间限制（毫秒时间戳），仅跟单截止时间小于此时间的订单，NULL表示不启用
 )
 /**
@@ -64,12 +71,19 @@ data class CopyTradingUpdateRequest(
    // 过滤条件
    val minOrderDepth: String? = null,
    val maxSpread: String? = null,
    val minOrderbookDepth: String? = null,
    val minPrice: String? = null,  // 最低价格（可选），NULL表示不限制最低价
    val maxPrice: String? = null,  // 最高价格（可选），NULL表示不限制最高价
    // 最大仓位配置
    val maxPositionValue: String? = null,  // 最大仓位金额（USDC），NULL表示不启用
    val maxPositionCount: Int? = null,  // 最大仓位数量，NULL表示不启用
    // 关键字过滤配置
    val keywordFilterMode: String? = null,  // 关键字过滤模式：DISABLED（不启用）、WHITELIST（白名单）、BLACKLIST（黑名单）
    val keywords: List<String>? = null,  // 关键字列表，当keywordFilterMode为DISABLED时为null
    // 新增配置字段
    val configName: String? = null,  // 配置名（可选，但提供时必须非空）
-    val pushFailedOrders: Boolean? = null  // 推送失败订单（可选）
+    val pushFailedOrders: Boolean? = null,  // 推送失败订单（可选）
    val pushFilteredOrders: Boolean? = null,  // 推送已过滤订单（可选）
    val maxMarketEndDate: Long? = null  // 市场截止时间限制（毫秒时间戳），仅跟单截止时间小于此时间的订单，NULL表示不启用
 )
 /**
@@ -133,12 +147,19 @@ data class CopyTradingDto(
    // 过滤条件
    val minOrderDepth: String?,
    val maxSpread: String?,
    val minOrderbookDepth: String?,
    val minPrice: String?,  // 最低价格（可选），NULL表示不限制最低价
    val maxPrice: String?,  // 最高价格（可选），NULL表示不限制最高价
    // 最大仓位配置
    val maxPositionValue: String? = null,  // 最大仓位金额（USDC），NULL表示不启用
    val maxPositionCount: Int? = null,  // 最大仓位数量，NULL表示不启用
    // 关键字过滤配置
    val keywordFilterMode: String? = null,  // 关键字过滤模式：DISABLED（不启用）、WHITELIST（白名单）、BLACKLIST（黑名单）
    val keywords: List<String>? = null,  // 关键字列表，当keywordFilterMode为DISABLED时为null
    // 新增配置字段
    val configName: String? = null,  // 配置名（可选）
    val pushFailedOrders: Boolean = false,  // 推送失败订单（默认关闭）
    val pushFilteredOrders: Boolean = false,  // 推送已过滤订单（默认关闭）
    val maxMarketEndDate: Long? = null,  // 市场截止时间限制（毫秒时间戳），仅跟单截止时间小于此时间的订单，NULL表示不启用
    val createdAt: Long,
    val updatedAt: Long
 )
@@ -40,6 +40,10 @@ data class BuyOrderInfo(
    val orderId: String,
    val leaderTradeId: String,
    val marketId: String,
    val marketTitle: String? = null,  // 市场名称
    val marketSlug: String? = null,  // 市场 slug（用于显示）
    val eventSlug: String? = null,  // 跳转用的 slug（从 events[0].slug 获取）
    val marketCategory: String? = null,  // 市场分类（sports, crypto 等）
    val side: String,
    val quantity: String,
    val price: String,
@@ -57,6 +61,10 @@ data class SellOrderInfo(
    val orderId: String,
    val leaderTradeId: String,
    val marketId: String,
    val marketTitle: String? = null,  // 市场名称
    val marketSlug: String? = null,  // 市场 slug（用于显示）
    val eventSlug: String? = null,  // 跳转用的 slug（从 events[0].slug 获取）
    val marketCategory: String? = null,  // 市场分类（sports, crypto 等）
    val side: String,
    val quantity: String,
    val price: String,
@@ -71,6 +79,11 @@ data class SellOrderInfo(
 data class MatchedOrderInfo(
    val sellOrderId: String,
    val buyOrderId: String,
    val marketId: String? = null,  // 市场ID（从买入订单获取）
    val marketTitle: String? = null,  // 市场名称
    val marketSlug: String? = null,  // 市场 slug（用于显示）
    val eventSlug: String? = null,  // 跳转用的 slug（从 events[0].slug 获取）
    val marketCategory: String? = null,  // 市场分类（sports, crypto 等）
    val matchedQuantity: String,
    val buyPrice: String,
    val sellPrice: String,
@@ -97,12 +110,60 @@ data class OrderTrackingRequest(
    val page: Int? = 1,
    val limit: Int? = 20,
    val marketId: String? = null,
-    val side: String? = null,
+    val marketTitle: String? = null,  // 市场标题关键字筛选
    val status: String? = null,
    val sellOrderId: String? = null,
    val buyOrderId: String? = null
 )
 /**
 * 按市场分组的订单查询请求
 */
 data class MarketGroupedOrdersRequest(
    val copyTradingId: Long,
    val type: String,  // buy, sell, matched
    val page: Int? = 1,
    val limit: Int? = 20,
    val marketId: String? = null,
    val marketTitle: String? = null
 )
 /**
 * 单个市场的订单统计信息
 */
 data class MarketOrderStats(
    val count: Long,
    val totalAmount: String,  // 总金额
    val totalPnl: String?,  // 总盈亏（买入订单未实现盈亏，此字段为空）
    val fullyMatched: Boolean,  // 是否全部成交
    val fullyMatchedCount: Long,  // 完全成交的订单数
    val partiallyMatchedCount: Long,  // 部分成交的订单数
    val filledCount: Long  // 未成交的订单数
 )
 /**
 * 单个市场分组的响应数据
 */
 data class MarketOrderGroup(
    val marketId: String,
    val marketTitle: String?,
    val marketSlug: String?,  // 显示用的 slug
    val eventSlug: String? = null,  // 跳转用的 slug（从 events[0].slug 获取）
    val marketCategory: String?,
    val stats: MarketOrderStats,
    val orders: List<Any>  // BuyOrderInfo, SellOrderInfo 或 MatchedOrderInfo 的列表
 )
 /**
 * 按市场分组的订单列表响应
 */
 data class MarketGroupedOrdersResponse(
    val list: List<MarketOrderGroup>,
    val total: Long,  // 市场总数
    val page: Int,
    val limit: Int
 )
 /**
 * 统计查询请求
 */
@@ -22,9 +22,9 @@ data class TemplateCreateRequest(
    // 过滤条件
    val minOrderDepth: String? = null,  // 最小订单深度（USDC金额），NULL表示不启用
    val maxSpread: String? = null,  // 最大价差（绝对价格），NULL表示不启用
    val minOrderbookDepth: String? = null,  // 最小订单簿深度（USDC金额），NULL表示不启用
    val minPrice: String? = null,  // 最低价格（可选），NULL表示不限制最低价
-    val maxPrice: String? = null  // 最高价格（可选），NULL表示不限制最高价
+    val maxPrice: String? = null,  // 最高价格（可选），NULL表示不限制最高价
    val pushFilteredOrders: Boolean? = null  // 推送已过滤订单（默认关闭）
 )
 /**
@@ -50,9 +50,9 @@ data class TemplateUpdateRequest(
    // 过滤条件
    val minOrderDepth: String? = null,  // 最小订单深度（USDC金额），NULL表示不启用
    val maxSpread: String? = null,  // 最大价差（绝对价格），NULL表示不启用
    val minOrderbookDepth: String? = null,  // 最小订单簿深度（USDC金额），NULL表示不启用
    val minPrice: String? = null,  // 最低价格（可选），NULL表示不限制最低价
-    val maxPrice: String? = null  // 最高价格（可选），NULL表示不限制最高价
+    val maxPrice: String? = null,  // 最高价格（可选），NULL表示不限制最高价
    val pushFilteredOrders: Boolean? = null  // 推送已过滤订单（默认关闭）
 )
 /**
@@ -85,9 +85,9 @@ data class TemplateCopyRequest(
    // 过滤条件
    val minOrderDepth: String? = null,  // 最小订单深度（USDC金额），NULL表示不启用
    val maxSpread: String? = null,  // 最大价差（绝对价格），NULL表示不启用
    val minOrderbookDepth: String? = null,  // 最小订单簿深度（USDC金额），NULL表示不启用
    val minPrice: String? = null,  // 最低价格（可选），NULL表示不限制最低价
-    val maxPrice: String? = null  // 最高价格（可选），NULL表示不限制最高价
+    val maxPrice: String? = null,  // 最高价格（可选），NULL表示不限制最高价
    val pushFilteredOrders: Boolean? = null  // 推送已过滤订单（默认关闭）
 )
 /**
@@ -120,9 +120,9 @@ data class TemplateDto(
    // 过滤条件
    val minOrderDepth: String?,
    val maxSpread: String?,
    val minOrderbookDepth: String?,
    val minPrice: String?,  // 最低价格（可选），NULL表示不限制最低价
    val maxPrice: String?,  // 最高价格（可选），NULL表示不限制最高价
    val pushFilteredOrders: Boolean,  // 推送已过滤订单（默认关闭）
    val createdAt: Long,
    val updatedAt: Long
 )
@@ -25,7 +25,8 @@ data class MarketDto(
    val liquidityNum: Double?,
    val bestBid: Double?,
    val bestAsk: Double?,
-    val lastTradePrice: Double?
+    val lastTradePrice: Double?,
    val events: List<MarketDto>? = null  // 事件列表（从 events[0] 获取 slug）
 )
 /**
@@ -37,9 +38,9 @@ data class OutcomeDto(
 )
 /**
- * 事件 DTO
+ * 事件 DTO（用于其他 API 调用）
 */
-data class EventDto(
+data class EventListDto(
    val id: String,
    val title: String,
    val category: String,
@@ -55,7 +56,7 @@ data class SeriesDto(
    val id: String,
    val title: String,
    val category: String,
-    val events: List<EventDto>?,
+    val events: List<EventListDto>?,
    val createdAt: Long?  // 时间戳（毫秒）
 )
@@ -70,4 +71,3 @@ data class CommentDto(
    val createdAt: Long,  // 时间戳（毫秒）
    val user: String?
 )
@@ -40,6 +40,9 @@ data class Account(
    @Column(name = "is_enabled", nullable = false)
    val isEnabled: Boolean = true,  // 是否启用（用于订单推送等功能的开关）
    @Column(name = "wallet_type", nullable = false, length = 20)
    val walletType: String = "magic",  // 钱包类型：magic（邮箱/OAuth登录）或 safe（MetaMask浏览器钱包）
    @Column(name = "created_at", nullable = false)
    val createdAt: Long = System.currentTimeMillis(),
@@ -38,6 +38,9 @@ data class CopyOrderTracking(
    @Column(name = "leader_buy_trade_id", nullable = false, length = 100)
    val leaderBuyTradeId: String,  // Leader 买入交易ID
    @Column(name = "leader_buy_quantity", nullable = true, precision = 20, scale = 8)
    val leaderBuyQuantity: BigDecimal? = null,  // Leader 买入数量（用于固定金额模式计算卖出比例）
    @Column(name = "quantity", nullable = false, precision = 20, scale = 8)
    val quantity: BigDecimal,  // 买入数量
@@ -53,6 +56,12 @@ data class CopyOrderTracking(
    @Column(name = "status", nullable = false, length = 20)
    var status: String = "filled",  // filled, fully_matched, partially_matched
    @Column(name = "notification_sent", nullable = false)
    var notificationSent: Boolean = false,  // 是否已发送通知（从订单详情获取实际数据后发送）
    @Column(name = "source", nullable = false, length = 20)
    val source: String,  // 订单来源：activity-ws（Polymarket WebSocket）、onchain-ws（OnChain WebSocket）
    @Column(name = "created_at", nullable = false)
    val createdAt: Long = System.currentTimeMillis(),
@@ -8,12 +8,7 @@ import com.wrbug.polymarketbot.util.toSafeBigDecimal
 * 跟单配置实体（独立配置，不再绑定模板）
 */
@Entity
-@Table(
+@Table(name = "copy_trading")
    name = "copy_trading",
    uniqueConstraints = [
        UniqueConstraint(columnNames = ["account_id", "leader_id"])
    ]
 )
 data class CopyTrading(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
@@ -32,7 +27,7 @@ data class CopyTrading(
    @Column(name = "copy_mode", nullable = false, length = 10)
    val copyMode: String = "RATIO",  // "RATIO" 或 "FIXED"
-    @Column(name = "copy_ratio", nullable = false, precision = 10, scale = 2)
+    @Column(name = "copy_ratio", nullable = false, precision = 20, scale = 8)
    val copyRatio: BigDecimal = BigDecimal.ONE,  // 仅在 copyMode="RATIO" 时生效
    @Column(name = "fixed_amount", precision = 20, scale = 8)
@@ -78,15 +73,26 @@ data class CopyTrading(
    @Column(name = "max_spread", precision = 20, scale = 8)
    val maxSpread: BigDecimal? = null,  // 最大价差（绝对价格），NULL表示不启用
    @Column(name = "min_orderbook_depth", precision = 20, scale = 8)
    val minOrderbookDepth: BigDecimal? = null,  // 最小订单簿深度（USDC金额），NULL表示不启用
    @Column(name = "min_price", precision = 20, scale = 8)
    val minPrice: BigDecimal? = null,  // 最低价格（可选），NULL表示不限制最低价
    @Column(name = "max_price", precision = 20, scale = 8)
    val maxPrice: BigDecimal? = null,  // 最高价格（可选），NULL表示不限制最高价
    // 最大仓位配置
    @Column(name = "max_position_value", precision = 20, scale = 8)
    val maxPositionValue: BigDecimal? = null,  // 最大仓位金额（USDC），NULL表示不启用
    @Column(name = "max_position_count")
    val maxPositionCount: Int? = null,  // 最大仓位数量，NULL表示不启用
    // 关键字过滤配置
    @Column(name = "keyword_filter_mode", nullable = false, length = 20)
    val keywordFilterMode: String = "DISABLED",  // 关键字过滤模式：DISABLED（不启用）、WHITELIST（白名单）、BLACKLIST（黑名单）
    @Column(name = "keywords", columnDefinition = "JSON")
    val keywords: String? = null,  // 关键字列表（JSON数组），例如：["NBA", "足球", "NBA总决赛"]，当keywordFilterMode为DISABLED时为NULL
    // 新增配置字段
    @Column(name = "config_name", length = 255)
    val configName: String? = null,  // 配置名（可选）
@@ -94,6 +100,12 @@ data class CopyTrading(
    @Column(name = "push_failed_orders", nullable = false)
    val pushFailedOrders: Boolean = false,  // 推送失败订单（默认关闭）
    @Column(name = "push_filtered_orders", nullable = false)
    val pushFilteredOrders: Boolean = false,  // 推送已过滤订单（默认关闭）
    @Column(name = "max_market_end_date")
    val maxMarketEndDate: Long? = null,  // 市场截止时间限制（毫秒时间戳），仅跟单截止时间小于此时间的订单，NULL表示不启用
    @Column(name = "created_at", nullable = false)
    val createdAt: Long = System.currentTimeMillis(),
@@ -20,7 +20,7 @@ data class CopyTradingTemplate(
    @Column(name = "copy_mode", nullable = false, length = 10)
    val copyMode: String = "RATIO",  // "RATIO" 或 "FIXED"
-    @Column(name = "copy_ratio", nullable = false, precision = 10, scale = 2)
+    @Column(name = "copy_ratio", nullable = false, precision = 20, scale = 8)
    val copyRatio: BigDecimal = BigDecimal.ONE,  // 仅在 copyMode="RATIO" 时生效
    @Column(name = "fixed_amount", precision = 20, scale = 8)
@@ -66,15 +66,15 @@ data class CopyTradingTemplate(
    @Column(name = "max_spread", precision = 20, scale = 8)
    val maxSpread: BigDecimal? = null,  // 最大价差（绝对价格），NULL表示不启用
    @Column(name = "min_orderbook_depth", precision = 20, scale = 8)
    val minOrderbookDepth: BigDecimal? = null,  // 最小订单簿深度（USDC金额），NULL表示不启用
    @Column(name = "min_price", precision = 20, scale = 8)
    val minPrice: BigDecimal? = null,  // 最低价格（可选），NULL表示不限制最低价
    @Column(name = "max_price", precision = 20, scale = 8)
    val maxPrice: BigDecimal? = null,  // 最高价格（可选），NULL表示不限制最高价
    @Column(name = "push_filtered_orders", nullable = false)
    val pushFilteredOrders: Boolean = false,  // 推送已过滤订单（默认关闭）
    @Column(name = "created_at", nullable = false)
    val createdAt: Long = System.currentTimeMillis(),
@@ -1,55 +0,0 @@
 package com.wrbug.polymarketbot.entity
 import jakarta.persistence.*
 /**
 * 失败交易实体
 * 记录处理失败的交易信息
 */
@Entity
@Table(name = "failed_trade")
 data class FailedTrade(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    val id: Long? = null,
    @Column(name = "leader_id", nullable = false)
    val leaderId: Long,
    @Column(name = "leader_trade_id", nullable = false, length = 100)
    val leaderTradeId: String,  // Leader 的交易ID
    @Column(name = "trade_type", nullable = false, length = 10)
    val tradeType: String,  // BUY 或 SELL
    @Column(name = "copy_trading_id", nullable = false)
    val copyTradingId: Long,
    @Column(name = "account_id", nullable = false)
    val accountId: Long,
    @Column(name = "market_id", nullable = false, length = 100)
    val marketId: String,
    @Column(name = "side", nullable = false, length = 10)
    val side: String,  // YES/NO
    @Column(name = "price", nullable = false, length = 50)
    val price: String,  // 价格（字符串格式）
    @Column(name = "size", nullable = false, length = 50)
    val size: String,  // 数量（字符串格式）
    @Column(name = "error_message", columnDefinition = "TEXT")
    val errorMessage: String? = null,  // 错误信息
    @Column(name = "retry_count", nullable = false)
    val retryCount: Int = 0,  // 重试次数
    @Column(name = "failed_at", nullable = false)
    val failedAt: Long = System.currentTimeMillis(),
    @Column(name = "created_at", nullable = false)
    val createdAt: Long = System.currentTimeMillis()
 )
@@ -0,0 +1,60 @@
 package com.wrbug.polymarketbot.entity
 import jakarta.persistence.*
 /**
 * 市场信息实体
 * 用于缓存市场的基本信息（名称、slug等）
 */
@Entity
@Table(name = "markets", indexes = [
    Index(name = "idx_market_id", columnList = "market_id", unique = true)
 ])
 data class Market(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    val id: Long? = null,
    @Column(name = "market_id", unique = true, nullable = false, length = 100)
    val marketId: String,  // 市场ID（condition ID）
    @Column(name = "title", nullable = false, length = 500)
    val title: String,  // 市场名称（question）
    @Column(name = "slug", length = 200)
    val slug: String? = null,  // 市场slug（用于显示）
    @Column(name = "event_slug", length = 200)
    val eventSlug: String? = null,  // 跳转用的 slug（从 events[0].slug 获取）
    @Column(name = "category", length = 50)
    val category: String? = null,  // 市场分类
    @Column(name = "icon", length = 500)
    val icon: String? = null,  // 市场图标URL
    @Column(name = "image", length = 500)
    val image: String? = null,  // 市场图片URL
    @Column(name = "description", columnDefinition = "TEXT")
    val description: String? = null,  // 市场描述
    @Column(name = "active", nullable = false)
    val active: Boolean = true,  // 是否活跃
    @Column(name = "closed", nullable = false)
    val closed: Boolean = false,  // 是否已关闭
    @Column(name = "archived", nullable = false)
    val archived: Boolean = false,  // 是否已归档
    @Column(name = "end_date")
    val endDate: Long? = null,  // 市场截止时间（毫秒时间戳）
    @Column(name = "created_at", nullable = false)
    val createdAt: Long = System.currentTimeMillis(),
    @Column(name = "updated_at", nullable = false)
    var updatedAt: Long = System.currentTimeMillis()
 )
@@ -0,0 +1,73 @@
 package com.wrbug.polymarketbot.entity
 import jakarta.persistence.*
 /**
 * Polygon RPC 节点配置实体
 * 用于存储用户配置的 RPC 节点信息
 */
@Entity
@Table(name = "rpc_node_config")
 data class RpcNodeConfig(
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    val id: Long? = null,
    @Column(name = "provider_type", nullable = false, length = 50)
    val providerType: String,  // 服务商类型: ALCHEMY, INFURA, QUICKNODE, CHAINSTACK, GETBLOCK, CUSTOM, PUBLIC
    @Column(name = "name", nullable = false, length = 100)
    val name: String,  // 节点名称
    @Column(name = "http_url", nullable = false, length = 500)
    val httpUrl: String,  // HTTP RPC URL
    @Column(name = "ws_url", length = 500)
    val wsUrl: String? = null,  // WebSocket URL (可选)
    @Column(name = "api_key", length = 200)
    val apiKey: String? = null,  // API Key (加密存储)
    @Column(name = "enabled", nullable = false)
    var enabled: Boolean = true,  // 是否启用
    @Column(name = "priority", nullable = false)
    var priority: Int = 0,  // 优先级(数字越小优先级越高)
    @Column(name = "last_check_time")
    var lastCheckTime: Long? = null,  // 最后检查时间(毫秒时间戳)
    @Column(name = "last_check_status", length = 20)
    var lastCheckStatus: String? = null,  // 最后检查状态: HEALTHY, UNHEALTHY, UNKNOWN
    @Column(name = "response_time_ms")
    var responseTimeMs: Int? = null,  // 最后一次响应时间(毫秒)
    @Column(name = "created_at", nullable = false)
    val createdAt: Long = System.currentTimeMillis(),
    @Column(name = "updated_at", nullable = false)
    var updatedAt: Long = System.currentTimeMillis()
 )
 /**
 * RPC 节点健康状态枚举
 */
 enum class NodeHealthStatus {
    HEALTHY,    // 健康
    UNHEALTHY,  // 不健康
    UNKNOWN     // 未知
 }
 /**
 * RPC 节点服务商类型枚举
 */
 enum class RpcProviderType {
    ALCHEMY,
    INFURA,
    QUICKNODE,
    CHAINSTACK,
    GETBLOCK,
    CUSTOM,
    PUBLIC
 }
@@ -41,6 +41,9 @@ data class SellMatchRecord(
    @Column(name = "total_realized_pnl", nullable = false, precision = 20, scale = 8)
    val totalRealizedPnl: BigDecimal,  // 总已实现盈亏
    @Column(name = "price_updated", nullable = false)
    var priceUpdated: Boolean = false,  // 共用字段：false 表示未处理（未查询订单详情，未发送通知），true 表示已处理（已查询订单详情，已发送通知）
    @Column(name = "created_at", nullable = false)
    val createdAt: Long = System.currentTimeMillis()
 )
@@ -50,5 +50,53 @@ interface CopyOrderTrackingRepository : JpaRepository<CopyOrderTracking, Long> {
     * 根据买入订单ID查询订单跟踪记录
     */
    fun findByBuyOrderId(buyOrderId: String): List<CopyOrderTracking>
    /**
     * 查询未发送通知的买入订单（用于轮询更新）
     */
    fun findByNotificationSentFalse(): List<CopyOrderTracking>
    /**
     * 查询指定时间之前创建的订单（用于检查30秒后未成交的订单）
     */
    @Query("SELECT t FROM CopyOrderTracking t WHERE t.createdAt <= :beforeTime")
    fun findByCreatedAtBefore(beforeTime: Long): List<CopyOrderTracking>
    /**
     * 查询指定时间之前创建且状态不为指定状态的订单
     */
    fun findByCreatedAtBeforeAndStatusNot(beforeTime: Long, status: String): List<CopyOrderTracking>
    /**
     * 查询指定跟单配置下的活跃仓位数量
     * 活跃仓位定义为 remainingQuantity > 0 的不同 (marketId, outcomeIndex) 组合
     */
    @Query("SELECT COUNT(DISTINCT CONCAT(t.marketId, '_', COALESCE(t.outcomeIndex, -1))) FROM CopyOrderTracking t WHERE t.copyTradingId = :copyTradingId AND t.remainingQuantity > 0")
    fun countActivePositions(copyTradingId: Long): Int
    /**
     * 计算指定跟单配置、市场和方向下的当前持仓总价值 (成本价计算)
     * 按市场+方向（outcomeIndex）分别统计
     */
    @Query("SELECT SUM(t.remainingQuantity * t.price) FROM CopyOrderTracking t WHERE t.copyTradingId = :copyTradingId AND t.marketId = :marketId AND t.outcomeIndex = :outcomeIndex AND t.remainingQuantity > 0")
    fun sumCurrentPositionValueByMarketAndOutcomeIndex(copyTradingId: Long, marketId: String, outcomeIndex: Int): BigDecimal?
    /**
     * 查询指定跟单配置下，创建时间超过指定时间点的未匹配订单（FIFO顺序）
     * 用于避免刚创建的订单被误判为已卖出
     *
     * @param copyTradingId 跟单配置ID
     * @param marketId 市场ID
     * @param outcomeIndex 结果索引
     * @param thresholdTime 时间阈值（毫秒时间戳），只查询创建时间小于该值的订单
     * @return 未匹配订单列表（按创建时间升序排列）
     */
    @Query("SELECT t FROM CopyOrderTracking t WHERE t.copyTradingId = :copyTradingId AND t.marketId = :marketId AND t.outcomeIndex = :outcomeIndex AND t.remainingQuantity > 0 AND t.createdAt < :thresholdTime ORDER BY t.createdAt ASC")
    fun findUnmatchedBuyOrdersByOutcomeIndexOlderThan(
        copyTradingId: Long,
        marketId: String,
        outcomeIndex: Int,
        thresholdTime: Long
    ): List<CopyOrderTracking>
 }
@@ -21,12 +21,12 @@ interface CopyTradingRepository : JpaRepository<CopyTrading, Long> {
    fun findByLeaderId(leaderId: Long): List<CopyTrading>
    /**
-     * 根据账户ID和Leader ID查找跟单
+     * 根据账户ID和Leader ID查找跟单列表
     */
    fun findByAccountIdAndLeaderId(
        accountId: Long,
        leaderId: Long
-    ): CopyTrading?
+    ): List<CopyTrading>
    /**
     * 查找所有启用的跟单
@@ -1,23 +0,0 @@
 package com.wrbug.polymarketbot.repository
 import com.wrbug.polymarketbot.entity.FailedTrade
 import org.springframework.data.jpa.repository.JpaRepository
 import org.springframework.stereotype.Repository
 /**
 * 失败交易Repository
 */
@Repository
 interface FailedTradeRepository : JpaRepository<FailedTrade, Long> {
    /**
     * 根据Leader ID和交易ID查询
     */
    fun findByLeaderIdAndLeaderTradeId(leaderId: Long, leaderTradeId: String): FailedTrade?
    /**
     * 检查是否存在失败的交易
     */
    fun existsByLeaderIdAndLeaderTradeId(leaderId: Long, leaderTradeId: String): Boolean
 }
@@ -0,0 +1,12 @@
 package com.wrbug.polymarketbot.repository
 import com.wrbug.polymarketbot.entity.Market
 import org.springframework.data.jpa.repository.JpaRepository
 import org.springframework.stereotype.Repository
@Repository
 interface MarketRepository : JpaRepository<Market, Long> {
    fun findByMarketId(marketId: String): Market?
    fun findByMarketIdIn(marketIds: List<String>): List<Market>
 }
@@ -0,0 +1,23 @@
 package com.wrbug.polymarketbot.repository
 import com.wrbug.polymarketbot.entity.RpcNodeConfig
 import org.springframework.data.jpa.repository.JpaRepository
 import org.springframework.stereotype.Repository
@Repository
 interface RpcNodeConfigRepository : JpaRepository<RpcNodeConfig, Long> {
    /**
     * 查询所有已启用的节点,按优先级排序(优先级数字越小越靠前)
     */
    fun findAllByEnabledTrueOrderByPriorityAsc(): List<RpcNodeConfig>
    /**
     * 查询指定 ID 的已启用节点
     */
    fun findByIdAndEnabledTrue(id: Long): RpcNodeConfig?
    /**
     * 查询所有节点,按优先级排序
     */
    fun findAllByOrderByPriorityAsc(): List<RpcNodeConfig>
 }
@@ -24,5 +24,11 @@ interface SellMatchRecordRepository : JpaRepository<SellMatchRecord, Long> {
     * 根据Leader卖出交易ID查询记录
     */
    fun findByLeaderSellTradeId(leaderSellTradeId: String): SellMatchRecord?
    /**
     * 查询所有价格未更新的卖出记录
     * 注意：priceUpdated 现在同时表示价格已更新和通知已发送（共用字段）
     */
    fun findByPriceUpdatedFalse(): List<SellMatchRecord>
 }
@@ -1,213 +0,0 @@
 package com.wrbug.polymarketbot.service
 import com.wrbug.polymarketbot.api.OrderbookResponse
 import com.wrbug.polymarketbot.entity.CopyTrading
 import com.wrbug.polymarketbot.util.gt
 import com.wrbug.polymarketbot.util.lt
 import com.wrbug.polymarketbot.util.multi
 import com.wrbug.polymarketbot.util.toSafeBigDecimal
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
 import java.math.BigDecimal
 /**
 * 跟单过滤条件检查服务
 */
@Service
 class CopyTradingFilterService(
    private val clobService: PolymarketClobService
 ) {
    private val logger = LoggerFactory.getLogger(CopyTradingFilterService::class.java)
    /**
     * 检查过滤条件
     * @param copyTrading 跟单配置
     * @param tokenId token ID（用于获取订单簿）
     * @param isBuyOrder 是否为买入订单（true=买入，false=卖出）
     * @return Pair<是否通过, 失败原因>
     */
    suspend fun checkFilters(
        copyTrading: CopyTrading,
        tokenId: String,
        isBuyOrder: Boolean,
        tradePrice: BigDecimal? = null  // Leader 交易价格，用于价格区间检查
    ): Pair<Boolean, String> {
        // 1. 价格区间检查（如果配置了价格区间）
        if (tradePrice != null) {
            val priceRangeCheck = checkPriceRange(copyTrading, tradePrice)
            if (!priceRangeCheck.first) {
                return priceRangeCheck
            }
        }
        // 2. 价格合理性检查（基础检查，无需配置）
        // 这个检查在获取订单簿时进行，如果价格不在 0.01-0.99 范围内，订单簿获取会失败
        // 3. 获取订单簿
        val orderbookResult = clobService.getOrderbookByTokenId(tokenId)
        if (!orderbookResult.isSuccess) {
            val error = orderbookResult.exceptionOrNull()
            return Pair(false, "获取订单簿失败: ${error?.message ?: "未知错误"}")
        }
        val orderbook = orderbookResult.getOrNull()
        if (orderbook == null) {
            return Pair(false, "订单簿为空")
        }
        // 4. 买一卖一价差过滤
        val spreadCheck = checkSpread(copyTrading, orderbook)
        if (!spreadCheck.first) {
            return spreadCheck
        }
        // 5. 订单深度过滤
        val depthCheck = checkOrderDepth(copyTrading, orderbook, isBuyOrder)
        if (!depthCheck.first) {
            return depthCheck
        }
        // 6. 最小订单簿深度过滤（可选）
        val orderbookDepthCheck = checkOrderbookDepth(copyTrading, orderbook, isBuyOrder)
        if (!orderbookDepthCheck.first) {
            return orderbookDepthCheck
        }
        return Pair(true, "")
    }
    /**
     * 检查价格区间
     * @param copyTrading 跟单配置
     * @param tradePrice Leader 交易价格
     * @return Pair<是否通过, 失败原因>
     */
    private fun checkPriceRange(
        copyTrading: CopyTrading,
        tradePrice: BigDecimal
    ): Pair<Boolean, String> {
        // 如果未配置价格区间，直接通过
        if (copyTrading.minPrice == null && copyTrading.maxPrice == null) {
            return Pair(true, "")
        }
        // 检查最低价格
        if (copyTrading.minPrice != null && tradePrice.lt(copyTrading.minPrice)) {
            return Pair(false, "价格低于最低限制: $tradePrice < ${copyTrading.minPrice}")
        }
        // 检查最高价格
        if (copyTrading.maxPrice != null && tradePrice.gt(copyTrading.maxPrice)) {
            return Pair(false, "价格高于最高限制: $tradePrice > ${copyTrading.maxPrice}")
        }
        return Pair(true, "")
    }
    /**
     * 检查买一卖一价差
     * bestBid: 买盘中的最高价格（最大值）
     * bestAsk: 卖盘中的最低价格（最小值）
     */
    private fun checkSpread(
        copyTrading: CopyTrading,
        orderbook: OrderbookResponse
    ): Pair<Boolean, String> {
        // 如果未启用价差过滤，直接通过
        if (copyTrading.maxSpread == null) {
            return Pair(true, "")
        }
        // 获取买盘中的最高价格（bestBid = bids 中的最大值）
        val bestBid = orderbook.bids
            .mapNotNull { it.price.toSafeBigDecimal() }
            .maxOrNull()
        // 获取卖盘中的最低价格（bestAsk = asks 中的最小值）
        val bestAsk = orderbook.asks
            .mapNotNull { it.price.toSafeBigDecimal() }
            .minOrNull()
        if (bestBid == null || bestAsk == null) {
            return Pair(false, "订单簿缺少买一或卖一价格")
        }
        // 计算价差（绝对价格）
        val spread = bestAsk.subtract(bestBid)
        if (spread.gt(copyTrading.maxSpread)) {
            return Pair(false, "价差过大: $spread > ${copyTrading.maxSpread}")
        }
        return Pair(true, "")
    }
    /**
     * 检查订单深度
     */
    private fun checkOrderDepth(
        copyTrading: CopyTrading,
        orderbook: OrderbookResponse,
        isBuyOrder: Boolean
    ): Pair<Boolean, String> {
        // 如果未启用订单深度过滤，直接通过
        if (copyTrading.minOrderDepth == null) {
            return Pair(true, "")
        }
        // 对于买入订单，检查卖盘（asks）深度
        // 对于卖出订单，检查买盘（bids）深度
        val orders = if (isBuyOrder) orderbook.asks else orderbook.bids
        // 计算总深度（累计订单金额）
        var totalDepth = BigDecimal.ZERO
        for (order in orders) {
            val price = order.price.toSafeBigDecimal()
            val size = order.size.toSafeBigDecimal()
            val orderAmount = price.multi(size)
            totalDepth = totalDepth.add(orderAmount)
        }
        if (totalDepth.lt(copyTrading.minOrderDepth)) {
            return Pair(false, "订单深度不足: $totalDepth < ${copyTrading.minOrderDepth}")
        }
        return Pair(true, "")
    }
    /**
     * 检查最小订单簿深度（前 N 档深度）
     */
    private fun checkOrderbookDepth(
        copyTrading: CopyTrading,
        orderbook: OrderbookResponse,
        isBuyOrder: Boolean
    ): Pair<Boolean, String> {
        // 如果未启用最小订单簿深度过滤，直接通过
        if (copyTrading.minOrderbookDepth == null) {
            return Pair(true, "")
        }
        // 对于买入订单，检查卖盘（asks）前 3 档深度
        // 对于卖出订单，检查买盘（bids）前 3 档深度
        val orders = if (isBuyOrder) orderbook.asks else orderbook.bids
        val topNOrders = orders.take(3)  // 前 3 档
        // 计算前 N 档总深度
        var totalDepth = BigDecimal.ZERO
        for (order in topNOrders) {
            val price = order.price.toSafeBigDecimal()
            val size = order.size.toSafeBigDecimal()
            val orderAmount = price.multi(size)
            totalDepth = totalDepth.add(orderAmount)
        }
        if (totalDepth.lt(copyTrading.minOrderbookDepth)) {
            return Pair(false, "订单簿深度不足: $totalDepth < ${copyTrading.minOrderbookDepth}")
        }
        return Pair(true, "")
    }
 }
@@ -1,115 +0,0 @@
 package com.wrbug.polymarketbot.service
 import com.wrbug.polymarketbot.entity.CopyTrading
 import com.wrbug.polymarketbot.entity.Leader
 import com.wrbug.polymarketbot.repository.CopyTradingRepository
 import com.wrbug.polymarketbot.repository.LeaderRepository
 import jakarta.annotation.PostConstruct
 import jakarta.annotation.PreDestroy
 import kotlinx.coroutines.*
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
 /**
 * 跟单监听服务（主服务）
 * 管理所有Leader的交易监听（使用轮询方式）
 * 注意：WebSocket 需要认证才能订阅其他用户的交易，因此只使用轮询方式
 */
@Service
 class CopyTradingMonitorService(
    private val copyTradingRepository: CopyTradingRepository,
    private val leaderRepository: LeaderRepository,
    private val pollingService: CopyTradingPollingService
 ) {
    private val logger = LoggerFactory.getLogger(CopyTradingMonitorService::class.java)
    private val scope = CoroutineScope(Dispatchers.Default + SupervisorJob())
    /**
     * 系统启动时初始化监听
     */
    @PostConstruct
    fun init() {
        scope.launch {
            try {
                startMonitoring()
            } catch (e: Exception) {
                logger.error("启动跟单监听失败", e)
            }
        }
    }
    /**
     * 系统关闭时清理资源
     */
    @PreDestroy
    fun destroy() {
        scope.cancel()
        // 只使用轮询，不使用WebSocket
        pollingService.stop()
    }
    /**
     * 启动监听
     */
    suspend fun startMonitoring() {
        // 1. 获取所有启用的跟单关系
        val enabledCopyTradings = copyTradingRepository.findByEnabledTrue()
        if (enabledCopyTradings.isEmpty()) {
            return
        }
        // 2. 获取所有需要监听的Leader（去重）
        val leaderIds = enabledCopyTradings.map { it.leaderId }.distinct()
        val leaders = leaderIds.mapNotNull { leaderId ->
            leaderRepository.findById(leaderId).orElse(null)
        }
        // 3. 启动轮询监听（使用 /activity 接口，不需要认证）
        // 注意：WebSocket 需要认证才能订阅其他用户的交易，因此禁用WebSocket，只使用轮询
        pollingService.start(leaders)
    }
    /**
     * 添加Leader监听（当创建新的跟单关系时调用）
     */
    suspend fun addLeaderMonitoring(leaderId: Long) {
        val leader = leaderRepository.findById(leaderId).orElse(null)
            ?: return
        val copyTradings = copyTradingRepository.findByLeaderIdAndEnabledTrue(leaderId)
        if (copyTradings.isEmpty()) {
            return
        }
        // 只使用轮询，不使用WebSocket（需要认证）
        pollingService.addLeader(leader)
    }
    /**
     * 移除Leader监听（当删除跟单关系时调用）
     */
    suspend fun removeLeaderMonitoring(leaderId: Long) {
        val copyTradings = copyTradingRepository.findByLeaderIdAndEnabledTrue(leaderId)
        if (copyTradings.isNotEmpty()) {
            return
        }
        // 只使用轮询，不使用WebSocket
        pollingService.removeLeader(leaderId)
    }
    /**
     * 重新启动监听（当跟单关系状态改变时调用）
     */
    suspend fun restartMonitoring() {
        // 只使用轮询，不使用WebSocket
        pollingService.stop()
        delay(1000)  // 等待1秒
        startMonitoring()
    }
 }
@@ -1,278 +0,0 @@
 package com.wrbug.polymarketbot.service
 import com.wrbug.polymarketbot.api.TradeResponse
 import com.wrbug.polymarketbot.api.UserActivityResponse
 import com.wrbug.polymarketbot.entity.Leader
 import com.wrbug.polymarketbot.repository.CopyTradingTemplateRepository
 import com.wrbug.polymarketbot.util.RetrofitFactory
 import jakarta.annotation.PreDestroy
 import kotlinx.coroutines.*
 import org.slf4j.LoggerFactory
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.stereotype.Service
 import retrofit2.Response
 import java.util.concurrent.ConcurrentHashMap
 /**
 * 跟单轮询监听服务
 * 通过定期轮询 Polymarket Data API 的 /activity 接口获取Leader的交易记录
 * 使用 /activity 接口可以查询用户的链上活动，包括交易
 */
@Service
 class CopyTradingPollingService(
    private val copyOrderTrackingService: CopyOrderTrackingService,
    private val retrofitFactory: RetrofitFactory,
    private val templateRepository: CopyTradingTemplateRepository
 ) {
    private val logger = LoggerFactory.getLogger(CopyTradingPollingService::class.java)
    @Value("\${copy.trading.polling.interval:2000}")
    private var pollingInterval: Long = 2000  // 轮询间隔（毫秒），默认2秒
    @Value("\${copy.trading.polling.enabled:true}")
    private var pollingEnabled: Boolean = true  // 是否启用轮询
    private val scope = CoroutineScope(Dispatchers.Default + SupervisorJob())
    // 存储需要监听的Leader：leaderId -> Leader
    private val monitoredLeaders = ConcurrentHashMap<Long, Leader>()
    // 存储每个Leader已缓存的交易ID集合：leaderId -> Set<tradeId>
    private val cachedTradeIds = ConcurrentHashMap<Long, MutableSet<String>>()
    // 存储每个Leader是否首次轮询：leaderId -> isFirstPoll
    private val isFirstPoll = ConcurrentHashMap<Long, Boolean>()
    // 轮询任务
    private var pollingJob: Job? = null
    /**
     * 启动轮询监听
     */
    fun start(leaders: List<Leader>) {
        if (!pollingEnabled) {
            return
        }
        leaders.forEach { leader ->
            addLeader(leader)
        }
        // 启动轮询任务
        startPolling()
    }
    /**
     * 添加Leader监听
     */
    fun addLeader(leader: Leader) {
        if (leader.id == null) {
            logger.warn("Leader ID为空，跳过: ${leader.leaderAddress}")
            return
        }
        val leaderId = leader.id!!
        monitoredLeaders[leaderId] = leader
        // 初始化缓存的交易ID集合
        cachedTradeIds[leaderId] = mutableSetOf()
        // 首次轮询标志，用于缓存数据而不处理
        isFirstPoll[leaderId] = true
        // 如果轮询任务没有运行，启动它
        startPolling()
    }
    /**
     * 移除Leader监听
     */
    fun removeLeader(leaderId: Long) {
        monitoredLeaders.remove(leaderId)
        cachedTradeIds.remove(leaderId)
        isFirstPoll.remove(leaderId)
        // 如果没有需要监听的Leader了，停止轮询任务
        if (monitoredLeaders.isEmpty()) {
            stopPolling()
        }
    }
    /**
     * 停止所有监听
     */
    fun stop() {
        stopPolling()
        monitoredLeaders.clear()
        cachedTradeIds.clear()
        isFirstPoll.clear()
    }
    /**
     * 启动轮询任务
     */
    private fun startPolling() {
        if (pollingJob != null && pollingJob!!.isActive) {
            return
        }
        if (monitoredLeaders.isEmpty()) {
            return
        }
        pollingJob = scope.launch {
            while (isActive) {
                try {
                    // 轮询所有Leader的交易
                    pollAllLeaders()
                    // 等待下一次轮询
                    delay(pollingInterval)
                } catch (e: Exception) {
                    logger.error("轮询任务异常", e)
                    delay(pollingInterval)  // 异常后继续等待
                }
            }
        }
    }
    /**
     * 停止轮询任务
     */
    private fun stopPolling() {
        pollingJob?.cancel()
        pollingJob = null
    }
    /**
     * 轮询所有Leader的交易
     */
    private suspend fun pollAllLeaders() {
        val leaders = monitoredLeaders.values.toList()
        if (leaders.isEmpty()) {
            return
        }
        // 并发轮询所有Leader（限制并发数）
        leaders.chunked(10).forEach { chunk ->
            chunk.forEach { leader ->
                try {
                    pollLeaderTrades(leader)
                } catch (e: Exception) {
                    logger.error("轮询Leader交易失败: leaderId=${leader.id}, address=${leader.leaderAddress}", e)
                }
            }
            // 每个chunk之间稍作延迟，避免API限流
            delay(100)
        }
    }
    /**
     * 轮询单个Leader的交易
     * 使用 Polymarket Data API 的 /activity 接口
     * 通过 diff 分析增量数据，不使用 start 字段
     */
    private suspend fun pollLeaderTrades(leader: Leader) {
        if (leader.id == null) {
            return
        }
        val leaderId = leader.id!!
        val leaderAddress = leader.leaderAddress
        try {
            val firstPoll = isFirstPoll[leaderId] == true
            val cachedIds = cachedTradeIds[leaderId] ?: mutableSetOf()
            // 创建 Data API 客户端（不需要认证）
            val dataApi = retrofitFactory.createDataApi()
            // 查询用户活动（只查询交易类型，不使用 start 字段）
            // 查询最近的数据（limit=100），通过 diff 找出增量
            val response: Response<List<UserActivityResponse>> = dataApi.getUserActivity(
                user = leaderAddress,
                limit = 100,  // 每次最多查询100条
                offset = 0,
                type = listOf("TRADE"),  // 只查询交易类型
                start = null,  // 不使用 start 字段
                sortBy = "TIMESTAMP",
                sortDirection = "DESC"  // 按时间戳降序，最新的在前
            )
            if (!response.isSuccessful || response.body() == null) {
                logger.warn("获取Leader活动失败: leaderId=$leaderId, address=$leaderAddress, code=${response.code()}, message=${response.message()}")
                return
            }
            val activities = response.body()!!
            // 将 UserActivityResponse 转换为 TradeResponse
            val allTrades = activities.mapNotNull { activity ->
                // 只处理交易类型
                if (activity.type != "TRADE" || activity.side == null || activity.price == null || activity.size == null) {
                    return@mapNotNull null
                }
                // 转换为 TradeResponse
                TradeResponse(
                    id = activity.transactionHash ?: "${activity.timestamp}_${activity.conditionId}",
                    market = activity.conditionId,
                    side = activity.side,  // BUY 或 SELL
                    price = activity.price.toString(),
                    size = activity.size.toString(),
                    timestamp = activity.timestamp.toString(),  // 时间戳（秒）
                    user = activity.proxyWallet,
                    outcomeIndex = activity.outcomeIndex,  // 结果索引（0=YES, 1=NO）
                    outcome = activity.outcome  // 结果名称
                )
            }
            if (firstPoll) {
                // 首次轮询：缓存所有查询到的交易ID，不处理
                val tradeIds = allTrades.map { it.id }.toSet()
                cachedIds.addAll(tradeIds)
                cachedTradeIds[leaderId] = cachedIds
                // 标记首次轮询完成
                isFirstPoll[leaderId] = false
            } else {
                // 后续轮询：通过 diff 找出新增的交易
                val newTradeIds = allTrades.map { it.id }.toSet()
                val incrementalTradeIds = newTradeIds - cachedIds
                if (incrementalTradeIds.isNotEmpty()) {
                    // 找出新增的交易
                    val incrementalTrades = allTrades.filter { it.id in incrementalTradeIds }
                    // 处理新增的交易
                    incrementalTrades.forEach { trade ->
                        try {
                            // 检查是否已处理（去重由processTrade内部处理）
                            copyOrderTrackingService.processTrade(leaderId, trade, "polling")
                        } catch (e: Exception) {
                            logger.error("处理交易失败: leaderId=$leaderId, tradeId=${trade.id}", e)
                        }
                    }
                    // 更新缓存：添加新增的交易ID
                    cachedIds.addAll(incrementalTradeIds)
                    cachedTradeIds[leaderId] = cachedIds
                } else {
                }
                // 限制缓存大小，避免内存溢出（只保留最近1000条）
                if (cachedIds.size > 1000) {
                    // 保留最新的1000条（由于查询是按时间戳降序，保留前1000条即可）
                    val sortedTradeIds = allTrades.map { it.id }.take(1000).toSet()
                    cachedTradeIds[leaderId] = sortedTradeIds.toMutableSet()
                }
            }
        } catch (e: Exception) {
            logger.error("轮询Leader交易异常: leaderId=$leaderId, address=$leaderAddress", e)
        }
    }
 }
@@ -1,52 +0,0 @@
 package com.wrbug.polymarketbot.service
 import org.slf4j.LoggerFactory
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.stereotype.Service
 import java.util.concurrent.atomic.AtomicReference
 /**
 * 频率限制服务（使用内存缓存，全局限制）
 */
@Service
 class RateLimitService {
    private val logger = LoggerFactory.getLogger(RateLimitService::class.java)
    @Value("\${rate-limit.reset-password.max-attempts:3}")
    private var maxAttempts: Int = 3
    @Value("\${rate-limit.reset-password.window-seconds:60}")
    private var windowSeconds: Long = 60
    // 全局尝试记录列表（时间戳），所有请求共享
    private val resetPasswordAttempts = AtomicReference<MutableList<Long>>(mutableListOf())
    /**
     * 检查重置密码频率限制（全局限制，不按IP）
     * @return Result，如果超过限制则返回失败
     */
    fun checkResetPasswordRateLimit(): Result<Unit> {
        val now = System.currentTimeMillis()
        val windowStart = now - (windowSeconds * 1000)
        // 获取当前尝试记录列表
        val attempts = resetPasswordAttempts.get()
        // 清理过期记录（超过时间窗口的记录）
        val validAttempts = attempts.filter { it >= windowStart }.toMutableList()
        // 检查是否超过限制
        if (validAttempts.size >= maxAttempts) {
            logger.warn("重置密码频率限制触发: attempts=${validAttempts.size}/$maxAttempts")
            return Result.failure(IllegalStateException("频率限制：1分钟内最多尝试${maxAttempts}次，请稍后再试"))
        }
        // 记录本次尝试
        validAttempts.add(now)
        resetPasswordAttempts.set(validAttempts)
        return Result.success(Unit)
    }
 }
@@ -1,4 +1,4 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.accounts
 import com.wrbug.polymarketbot.api.TradeResponse
 import com.wrbug.polymarketbot.dto.*
@@ -8,6 +8,16 @@ import com.wrbug.polymarketbot.util.RetrofitFactory
 import com.wrbug.polymarketbot.util.toSafeBigDecimal
 import com.wrbug.polymarketbot.util.eq
 import com.wrbug.polymarketbot.util.JsonUtils
 import com.wrbug.polymarketbot.util.getEventSlug
 import com.wrbug.polymarketbot.service.common.PolymarketClobService
 import com.wrbug.polymarketbot.service.common.BlockchainService
 import com.wrbug.polymarketbot.service.common.MarketService
 import com.wrbug.polymarketbot.service.common.PolymarketApiKeyService
 import com.wrbug.polymarketbot.service.copytrading.orders.OrderPushService
 import com.wrbug.polymarketbot.service.copytrading.orders.OrderSigningService
 import com.wrbug.polymarketbot.service.system.TelegramNotificationService
 import com.wrbug.polymarketbot.service.system.RelayClientService
 import com.wrbug.polymarketbot.util.CryptoUtils
 import kotlinx.coroutines.*
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
@@ -27,9 +37,11 @@ class AccountService(
    private val apiKeyService: PolymarketApiKeyService,
    private val orderPushService: OrderPushService,
    private val orderSigningService: OrderSigningService,
-    private val cryptoUtils: com.wrbug.polymarketbot.util.CryptoUtils,
+    private val cryptoUtils: CryptoUtils,
    private val marketService: MarketService,  // 市场信息服务
    private val telegramNotificationService: TelegramNotificationService? = null,  // 可选，避免循环依赖
-    private val relayClientService: RelayClientService
+    private val relayClientService: RelayClientService,
    private val jsonUtils: JsonUtils
 ) {
    private val logger = LoggerFactory.getLogger(AccountService::class.java)
@@ -90,8 +102,9 @@ class AccountService(
            }
            // 5. 获取代理地址（必须成功，否则导入失败）
            // 根据用户选择的钱包类型计算代理地址
            val proxyAddress = runBlocking {
-                val proxyResult = blockchainService.getProxyAddress(request.walletAddress)
+                val proxyResult = blockchainService.getProxyAddress(request.walletAddress, request.walletType)
                if (proxyResult.isSuccess) {
                    val address = proxyResult.getOrNull()
                    if (address != null) {
@@ -141,6 +154,7 @@ class AccountService(
                accountName = accountName,
                isDefault = false,  // 不再支持默认账户
                isEnabled = request.isEnabled,
                walletType = request.walletType,  // 保存钱包类型
                createdAt = System.currentTimeMillis(),
                updatedAt = System.currentTimeMillis()
            )
@@ -217,11 +231,12 @@ class AccountService(
    /**
     * 查询账户列表
     * 列表接口只返回基本信息，不查询统计信息（统计信息只在详情接口中查询）
     */
    fun getAccountList(): Result<AccountListResponse> {
        return try {
            val accounts = accountRepository.findAllByOrderByCreatedAtAsc()
-            val accountDtos = accounts.map { toDto(it) }
+            val accountDtos = accounts.map { toBasicDto(it) }
            Result.success(
                AccountListResponse(
@@ -342,7 +357,30 @@ class AccountService(
    }
    /**
-     * 转换为 DTO
+     * 转换为基础 DTO（列表使用，不包含统计信息）
     * 列表接口只返回基本信息，不查询统计信息，以提高性能
     */
    private fun toBasicDto(account: Account): AccountDto {
        return AccountDto(
            id = account.id!!,
            walletAddress = account.walletAddress,
            proxyAddress = account.proxyAddress,
            accountName = account.accountName,
            isEnabled = account.isEnabled,
            walletType = account.walletType,
            apiKeyConfigured = account.apiKey != null,
            apiSecretConfigured = account.apiSecret != null,
            apiPassphraseConfigured = account.apiPassphrase != null,
            totalOrders = null,
            totalPnl = null,
            activeOrders = null,
            completedOrders = null,
            positionCount = null
        )
    }
    /**
     * 转换为完整 DTO（详情使用，包含交易统计数据）
     * 包含交易统计数据（总订单数、总盈亏、活跃订单数、已完成订单数、持仓数量）
     */
    private fun toDto(account: Account): AccountDto {
@@ -354,6 +392,7 @@ class AccountService(
                proxyAddress = account.proxyAddress,
                accountName = account.accountName,
                isEnabled = account.isEnabled,
                walletType = account.walletType,
                apiKeyConfigured = account.apiKey != null,
                apiSecretConfigured = account.apiSecret != null,
                apiPassphraseConfigured = account.apiPassphrase != null,
@@ -620,7 +659,8 @@ class AccountService(
                                    proxyAddress = account.proxyAddress,
                                    marketId = pos.conditionId ?: "",
                                    marketTitle = pos.title ?: "",
-                                    marketSlug = pos.slug ?: "",
+                                    marketSlug = pos.slug ?: "",  // 显示用的 slug
                                    eventSlug = pos.eventSlug,  // 跳转用的 slug（从 events[0].slug 获取）
                                    marketIcon = pos.icon,  // 市场图标
                                    side = pos.outcome ?: "",
                                    outcomeIndex = pos.outcomeIndex,  // 添加 outcomeIndex
@@ -827,6 +867,15 @@ class AccountService(
            // 7. 解密私钥
            val decryptedPrivateKey = decryptPrivateKey(account)
            // 获取费率（根据 Polymarket Maker Rebates Program 要求）
            val feeRateResult = clobService.getFeeRate(tokenId)
            val feeRateBps = if (feeRateResult.isSuccess) {
                feeRateResult.getOrNull()?.toString() ?: "0"
            } else {
                logger.warn("获取费率失败，使用默认值 0: tokenId=$tokenId, error=${feeRateResult.exceptionOrNull()?.message}")
                "0"
            }
            // 11. 创建并签名订单（使用计算后的卖出数量）
            val signedOrder = try {
                orderSigningService.createAndSignOrder(
@@ -838,7 +887,7 @@ class AccountService(
                    size = sellQuantity.toPlainString(),  // 使用计算后的卖出数量
                    signatureType = 2,  // Browser Wallet（与正确订单数据一致）
                    nonce = "0",
-                    feeRateBps = "0",
+                    feeRateBps = feeRateBps,  // 使用动态获取的费率
                    expiration = expiration
                )
            } catch (e: Exception) {
@@ -888,37 +937,28 @@ class AccountService(
                    notificationScope.launch {
                        try {
                            // 获取市场信息（标题和slug）
-                            val marketInfo = withContext(Dispatchers.IO) {
+                            val market = marketService.getMarket(request.marketId)
-                                try {
+                            val marketTitle = market?.title ?: request.marketId
-                                    val gammaApi = retrofitFactory.createGammaApi()
+                            val marketSlug = market?.eventSlug  // 跳转用的 slug
-                                    val marketResponse = gammaApi.listMarkets(conditionIds = listOf(request.marketId))
+
                                    if (marketResponse.isSuccessful && marketResponse.body() != null) {
                                        marketResponse.body()!!.firstOrNull()
                                    } else {
                                        null
                                    }
                                } catch (e: Exception) {
                                    logger.warn("获取市场信息失败: ${e.message}", e)
                                    null
                                }
                            }
                            val marketTitle = marketInfo?.question ?: request.marketId
                            val marketSlug = marketInfo?.slug
                            // 获取当前语言设置（从 LocaleContextHolder）
                            val locale = try {
                                org.springframework.context.i18n.LocaleContextHolder.getLocale()
                            } catch (e: Exception) {
                                java.util.Locale("zh", "CN")  // 默认简体中文
                            }
-                            
+
                            // 使用当前时间作为订单创建时间
                            val orderTime = System.currentTimeMillis()
                            telegramNotificationService?.sendOrderSuccessNotification(
                                orderId = orderId,
                                marketTitle = marketTitle,
                                marketId = request.marketId,
                                marketSlug = marketSlug,
                                side = request.side,
                                price = sellPrice,  // 直接传递卖出价格
                                size = sellQuantity.toPlainString(),  // 直接传递卖出数量
                                accountName = account.accountName,
                                walletAddress = account.walletAddress,
                                clobApi = clobApi,
@@ -926,7 +966,8 @@ class AccountService(
                                apiSecret = try { cryptoUtils.decrypt(account.apiSecret!!) } catch (e: Exception) { null },
                                apiPassphrase = try { cryptoUtils.decrypt(account.apiPassphrase!!) } catch (e: Exception) { null },
                                walletAddressForApi = account.walletAddress,
-                                locale = locale
+                                locale = locale,
                                orderTime = orderTime  // 使用订单创建时间
                            )
                        } catch (e: Exception) {
                            logger.warn("发送订单成功通知失败: ${e.message}", e)
@@ -954,31 +995,17 @@ class AccountService(
                    notificationScope.launch {
                        try {
                            // 获取市场信息（标题和slug）
-                            val marketInfo = withContext(Dispatchers.IO) {
+                            val market = marketService.getMarket(request.marketId)
-                                try {
+                            val marketTitle = market?.title ?: request.marketId
-                                    val gammaApi = retrofitFactory.createGammaApi()
+                            val marketSlug = market?.eventSlug  // 跳转用的 slug
-                                    val marketResponse = gammaApi.listMarkets(conditionIds = listOf(request.marketId))
+
                                    if (marketResponse.isSuccessful && marketResponse.body() != null) {
                                        marketResponse.body()!!.firstOrNull()
                                    } else {
                                        null
                                    }
                                } catch (e: Exception) {
                                    logger.warn("获取市场信息失败: ${e.message}", e)
                                    null
                                }
                            }
                            val marketTitle = marketInfo?.question ?: request.marketId
                            val marketSlug = marketInfo?.slug
                            // 获取当前语言设置（从 LocaleContextHolder）
                            val locale = try {
                                org.springframework.context.i18n.LocaleContextHolder.getLocale()
                            } catch (e: Exception) {
                                java.util.Locale("zh", "CN")  // 默认简体中文
                            }
-                            
+
                            telegramNotificationService?.sendOrderFailureNotification(
                                marketTitle = marketTitle,
                                marketId = request.marketId,
@@ -1012,34 +1039,20 @@ class AccountService(
                notificationScope.launch {
                    try {
                        // 获取市场信息（标题和slug）
-                        val marketInfo = withContext(Dispatchers.IO) {
+                        val market = marketService.getMarket(request.marketId)
-                            try {
+                        val marketTitle = market?.title ?: request.marketId
-                                val gammaApi = retrofitFactory.createGammaApi()
+                        val marketSlug = market?.eventSlug  // 跳转用的 slug
-                                val marketResponse = gammaApi.listMarkets(conditionIds = listOf(request.marketId))
+
                                if (marketResponse.isSuccessful && marketResponse.body() != null) {
                                    marketResponse.body()!!.firstOrNull()
                                } else {
                                    null
                                }
                            } catch (e: Exception) {
                                logger.warn("获取市场信息失败: ${e.message}", e)
                                null
                            }
                        }
                        val marketTitle = marketInfo?.question ?: request.marketId
                        val marketSlug = marketInfo?.slug
                        // 获取当前语言设置（从 LocaleContextHolder）
                        val locale = try {
                            org.springframework.context.i18n.LocaleContextHolder.getLocale()
                        } catch (e: Exception) {
                            java.util.Locale("zh", "CN")  // 默认简体中文
                        }
-                        
+
                        // 只传递后端返回的 msg，不传递完整堆栈
                        val errorMsg = orderResponse.body()?.errorMsg ?: "创建订单失败"
-                        
+
                        telegramNotificationService?.sendOrderFailureNotification(
                            marketTitle = marketTitle,
                            marketId = request.marketId,
@@ -1070,7 +1083,7 @@ class AccountService(
    /**
     * 从订单表获取最优价（用于市价单）
     * 支持多元市场（二元、三元及以上）
-     * 委托给 PolymarketClobService.getOptimalPrice 方法
+     * 委托给 com.wrbug.polymarketbot.service.common.PolymarketClobService.getOptimalPrice 方法
     *
     * @param tokenId token ID（通过 marketId 和 outcomeIndex 计算得出）
     * @param isSellOrder 是否为卖出订单（true: 卖单，需要 bestBid；false: 买单，需要 bestAsk）
@@ -1111,7 +1124,7 @@ class AccountService(
                    // 如果目标 outcome 不是第一个（index != 0），需要转换价格
                    // 对于二元市场：第二个 outcome 的价格 = 1 - 第一个 outcome 的价格
                    if (outcomeIndex != null && outcomeIndex > 0) {
-                        val outcomes = JsonUtils.parseStringArray(market.outcomes)
+                        val outcomes = jsonUtils.parseStringArray(market.outcomes)
                        // 只对二元市场进行价格转换
                        if (outcomes.size == 2) {
                            // 保存原始第一个 outcome 的价格
@@ -1143,13 +1156,13 @@ class AccountService(
                        null
                    }
                    // 优先使用 lastPrice（最近成交价），如果没有则使用 bestBid，最后使用 midpoint
                    val currentPrice = lastPrice ?: bestBid ?: midpoint ?: "0"
                    Result.success(
                        MarketPriceResponse(
                            marketId = marketId,
-                            lastPrice = lastPrice,
+                            currentPrice = currentPrice
                            bestBid = bestBid,
                            bestAsk = bestAsk,
                            midpoint = midpoint
                        )
                    )
                } else {
@@ -1167,7 +1180,7 @@ class AccountService(
    /**
     * 获取可赎回仓位统计
     */
-    suspend fun getRedeemablePositionsSummary(accountId: Long? = null): Result<com.wrbug.polymarketbot.dto.RedeemablePositionsSummary> {
+    suspend fun getRedeemablePositionsSummary(accountId: Long? = null): Result<RedeemablePositionsSummary> {
        return try {
            val positionsResult = getAllPositions()
            positionsResult.fold(
@@ -1223,7 +1236,7 @@ class AccountService(
     * 赎回仓位
     * 支持多账户、多仓位赎回（自动按账户和市场分组）
     */
-    suspend fun redeemPositions(request: com.wrbug.polymarketbot.dto.PositionRedeemRequest): Result<com.wrbug.polymarketbot.dto.PositionRedeemResponse> {
+    suspend fun redeemPositions(request: PositionRedeemRequest): Result<PositionRedeemResponse> {
        return try {
            // 检查 Builder API Key 是否已配置
            if (!relayClientService.isBuilderApiKeyConfigured()) {
@@ -1,4 +1,4 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.accounts
 import com.wrbug.polymarketbot.dto.AccountPositionDto
 import com.wrbug.polymarketbot.entity.CopyOrderTracking
@@ -18,6 +18,10 @@ import jakarta.annotation.PostConstruct
 import jakarta.annotation.PreDestroy
 import org.springframework.context.MessageSource
 import org.springframework.context.i18n.LocaleContextHolder
 import com.wrbug.polymarketbot.service.system.SystemConfigService
 import com.wrbug.polymarketbot.service.system.RelayClientService
 import com.wrbug.polymarketbot.service.system.TelegramNotificationService
 import com.wrbug.polymarketbot.service.common.MarketPriceService
 import org.springframework.stereotype.Service
 import java.math.BigDecimal
 import java.util.concurrent.ConcurrentHashMap
@@ -39,7 +43,8 @@ class PositionCheckService(
    private val relayClientService: RelayClientService,
    private val telegramNotificationService: TelegramNotificationService?,
    private val accountRepository: AccountRepository,
-    private val messageSource: MessageSource
+    private val messageSource: MessageSource,
    private val marketPriceService: MarketPriceService
 ) {
    private val logger = LoggerFactory.getLogger(PositionCheckService::class.java)
@@ -57,6 +62,19 @@ class PositionCheckService(
    // 记录已发送提示的配置（避免重复推送）
    private val notifiedConfigs = ConcurrentHashMap<Long, Long>()  // accountId/copyTradingId -> lastNotificationTime
    // 待检查的仓位记录（延迟检测机制）
    // key: "accountId_marketId_outcomeIndex_copyTradingId"
    // value: PendingPositionCheck（包含订单列表和首次检测时间）
    private data class PendingPositionCheck(
        val accountId: Long,
        val marketId: String,
        val outcomeIndex: Int,
        val copyTradingId: Long,
        val orders: List<CopyOrderTracking>,
        val firstDetectedTime: Long  // 首次检测到仓位不存在的时间
    )
    private val pendingPositionChecks = ConcurrentHashMap<String, PendingPositionCheck>()
    // 同步锁，确保订阅任务的启动和停止是线程安全的
    private val lock = Any()
@@ -68,6 +86,7 @@ class PositionCheckService(
        logger.info("PositionCheckService 初始化，订阅仓位轮训事件")
        startSubscription()
        startCacheCleanup()
        startPendingPositionCheckTask()
    }
    /**
@@ -127,6 +146,121 @@ class PositionCheckService(
        }
    }
    /**
     * 启动待检查仓位的定期检查任务
     * 每30秒检查一次，如果超过3分钟且确实不存在，则标记为已卖出
     */
    private fun startPendingPositionCheckTask() {
        scope.launch(Dispatchers.IO) {
            while (isActive) {
                try {
                    delay(30000)  // 每30秒检查一次
                    checkPendingPositions()
                } catch (e: Exception) {
                    logger.error("检查待检查仓位异常: ${e.message}", e)
                }
            }
        }
    }
    /**
     * 检查待检查的仓位
     * 如果超过3分钟且确实不存在，则标记为已卖出
     * 如果存在，则删除记录
     */
    private suspend fun checkPendingPositions() {
        if (pendingPositionChecks.isEmpty()) {
            return
        }
        try {
            // 获取最新的仓位数据
            val result = accountService.getAllPositions()
            if (result.isFailure) {
                logger.warn("获取仓位数据失败，跳过待检查仓位验证: ${result.exceptionOrNull()?.message}")
                return
            }
            val positionListResponse = result.getOrNull() ?: return
            val currentPositions = positionListResponse.currentPositions
            // 按账户和市场分组当前仓位
            val positionsByAccountAndMarket = currentPositions.groupBy { 
                "${it.accountId}_${it.marketId}_${it.outcomeIndex ?: 0}"
            }
            val now = System.currentTimeMillis()
            val checkDelay = 180000L  // 3分钟 = 180000毫秒
            val toRemove = mutableListOf<String>()
            val toMarkAsSold = mutableListOf<PendingPositionCheck>()
            // 遍历所有待检查的仓位
            for ((key, pendingCheck) in pendingPositionChecks) {
                // 先过滤出仍然有效的订单（remainingQuantity > 0）
                val validOrders = pendingCheck.orders.filter { order ->
                    // 重新从数据库查询订单状态，确保数据是最新的
                    val currentOrder = copyOrderTrackingRepository.findById(order.id!!).orElse(null)
                    currentOrder != null && currentOrder.remainingQuantity > BigDecimal.ZERO
                }
                // 如果没有有效订单了，删除记录
                if (validOrders.isEmpty()) {
                    toRemove.add(key)
                    logger.info("待检查仓位的订单已全部处理，删除记录: marketId=${pendingCheck.marketId}, outcomeIndex=${pendingCheck.outcomeIndex}, accountId=${pendingCheck.accountId}, copyTradingId=${pendingCheck.copyTradingId}")
                    continue
                }
                val positionKey = "${pendingCheck.accountId}_${pendingCheck.marketId}_${pendingCheck.outcomeIndex}"
                val position = positionsByAccountAndMarket[positionKey]?.firstOrNull()
                if (position != null) {
                    // 仓位存在，删除记录
                    toRemove.add(key)
                    logger.info("待检查仓位已恢复，删除记录: marketId=${pendingCheck.marketId}, outcomeIndex=${pendingCheck.outcomeIndex}, accountId=${pendingCheck.accountId}, copyTradingId=${pendingCheck.copyTradingId}, elapsedTime=${now - pendingCheck.firstDetectedTime}ms")
                } else {
                    // 仓位不存在，检查是否超过3分钟
                    val elapsedTime = now - pendingCheck.firstDetectedTime
                    if (elapsedTime >= checkDelay) {
                        // 超过3分钟且确实不存在，标记为已卖出（使用有效订单）
                        toMarkAsSold.add(pendingCheck.copy(orders = validOrders))
                        toRemove.add(key)
                        logger.info("待检查仓位超过3分钟仍不存在，标记为已卖出: marketId=${pendingCheck.marketId}, outcomeIndex=${pendingCheck.outcomeIndex}, accountId=${pendingCheck.accountId}, copyTradingId=${pendingCheck.copyTradingId}, elapsedTime=${elapsedTime}ms, validOrderCount=${validOrders.size}, originalOrderCount=${pendingCheck.orders.size}")
                    } else {
                        // 未超过3分钟，更新订单列表（移除已处理的订单）
                        if (validOrders.size < pendingCheck.orders.size) {
                            pendingPositionChecks[key] = pendingCheck.copy(orders = validOrders)
                            logger.debug("更新待检查仓位记录，移除已处理的订单: marketId=${pendingCheck.marketId}, outcomeIndex=${pendingCheck.outcomeIndex}, validOrderCount=${validOrders.size}, originalOrderCount=${pendingCheck.orders.size}")
                        }
                        logger.debug("待检查仓位仍不存在，继续等待: marketId=${pendingCheck.marketId}, outcomeIndex=${pendingCheck.outcomeIndex}, accountId=${pendingCheck.accountId}, copyTradingId=${pendingCheck.copyTradingId}, elapsedTime=${elapsedTime}ms, remainingTime=${checkDelay - elapsedTime}ms")
                    }
                }
            }
            // 删除已恢复或已处理的记录
            toRemove.forEach { key ->
                pendingPositionChecks.remove(key)
            }
            // 标记为已卖出
            for (pendingCheck in toMarkAsSold) {
                try {
                    val currentPrice = getCurrentMarketPrice(pendingCheck.marketId, pendingCheck.outcomeIndex)
                    updateOrdersAsSold(
                        pendingCheck.orders,
                        currentPrice,
                        pendingCheck.copyTradingId,
                        pendingCheck.marketId,
                        pendingCheck.outcomeIndex
                    )
                } catch (e: Exception) {
                    logger.error("标记待检查仓位为已卖出失败: marketId=${pendingCheck.marketId}, outcomeIndex=${pendingCheck.outcomeIndex}, error=${e.message}", e)
                }
            }
        } catch (e: Exception) {
            logger.error("检查待检查仓位异常: ${e.message}", e)
        }
    }
    /**
     * 清理过期的缓存条目（超过2小时的记录）
     */
@@ -158,8 +292,16 @@ class PositionCheckService(
            notifiedConfigs.remove(key)
        }
-        if (expiredPositions.isNotEmpty() || expiredProcessed.isNotEmpty() || expiredConfigs.isNotEmpty()) {
+        // 清理过期的待检查仓位记录（超过1小时的记录，正常情况下应该在3分钟内处理完）
-            logger.debug("清理过期缓存: positions=${expiredPositions.size}, processed=${expiredProcessed.size}, configs=${expiredConfigs.size}")
+        val expiredPendingChecks = pendingPositionChecks.entries.filter { (_, check) ->
            (now - check.firstDetectedTime) > 3600000  // 1小时
        }
        expiredPendingChecks.forEach { (key, _) ->
            pendingPositionChecks.remove(key)
        }
        if (expiredPositions.isNotEmpty() || expiredProcessed.isNotEmpty() || expiredConfigs.isNotEmpty() || expiredPendingChecks.isNotEmpty()) {
            logger.debug("清理过期缓存: positions=${expiredPositions.size}, processed=${expiredProcessed.size}, configs=${expiredConfigs.size}, pendingChecks=${expiredPendingChecks.size}")
        }
    }
@@ -186,7 +328,7 @@ class PositionCheckService(
    /**
     * 逻辑1：处理待赎回仓位
-     * 按照以下逻辑处理：
+    https://clob.polymarket.com     * 按照以下逻辑处理：
     * 1. 无待赎回仓位：跳过
     * 2. (未配置apikey || autoredeem==false) && 有待赎回的仓位：发送通知事件
     * 3. (已配置) && 有待赎回的仓位：处理订单逻辑
@@ -366,17 +508,100 @@ class PositionCheckService(
                    val position = positionsByAccountAndMarket[positionKey]?.firstOrNull()
                    if (position == null) {
-                        // 仓位不存在，更新所有订单状态为已卖出
+                        // 仓位不存在，使用延迟检测机制
-                        val currentPrice = getCurrentMarketPrice(marketId, outcomeIndex)
+                        // 先查询创建时间超过2分钟的未匹配订单（SQL层过滤，避免刚创建的订单被误判）
-                        updateOrdersAsSold(orders, currentPrice, copyTrading.id!!, marketId, outcomeIndex)
+                        val now = System.currentTimeMillis()
                        val thresholdTime = now - 120000  // 2分钟 = 120000毫秒
                        val ordersToCheck = copyOrderTrackingRepository.findUnmatchedBuyOrdersByOutcomeIndexOlderThan(
                            copyTradingId = copyTrading.id!!,
                            marketId = marketId,
                            outcomeIndex = outcomeIndex,
                            thresholdTime = thresholdTime
                        )
                        if (ordersToCheck.isNotEmpty()) {
                            // 有订单创建时间超过2分钟，记录到待检查列表
                            val checkKey = "${copyTrading.accountId}_${marketId}_${outcomeIndex}_${copyTrading.id}"
                            // 如果已经存在记录，更新订单列表（可能订单状态有变化）
                            val existingCheck = pendingPositionChecks[checkKey]
                            if (existingCheck == null) {
                                // 首次检测到，记录
                                pendingPositionChecks[checkKey] = PendingPositionCheck(
                                    accountId = copyTrading.accountId,
                                    marketId = marketId,
                                    outcomeIndex = outcomeIndex,
                                    copyTradingId = copyTrading.id!!,
                                    orders = ordersToCheck,
                                    firstDetectedTime = now
                                )
                                logger.info("首次检测到仓位不存在，记录待检查: marketId=$marketId, outcomeIndex=$outcomeIndex, accountId=${copyTrading.accountId}, copyTradingId=${copyTrading.id}, orderCount=${ordersToCheck.size}, positionKey=$positionKey")
                            } else {
                                // 已存在记录，更新订单列表（可能订单状态有变化）
                                pendingPositionChecks[checkKey] = existingCheck.copy(orders = ordersToCheck)
                                logger.debug("更新待检查仓位记录: marketId=$marketId, outcomeIndex=$outcomeIndex, accountId=${copyTrading.accountId}, copyTradingId=${copyTrading.id}, orderCount=${ordersToCheck.size}, elapsedTime=${now - existingCheck.firstDetectedTime}ms")
                            }
                        } else {
                            // 订单创建时间不足2分钟，可能是刚创建的订单，暂时不处理
                            logger.debug("仓位不存在但无符合条件的订单（创建时间不足2分钟），暂不标记为已卖出: marketId=$marketId, outcomeIndex=$outcomeIndex, orderCount=${orders.size}, thresholdTime=$thresholdTime, positionKey=$positionKey")
                        }
                    } else {
                        // 有仓位，先检查是否有对应的待检查记录，如果有则删除（仓位已恢复）
                        val checkKey = "${copyTrading.accountId}_${marketId}_${outcomeIndex}_${copyTrading.id}"
                        val pendingCheck = pendingPositionChecks.remove(checkKey)
                        if (pendingCheck != null) {
                            logger.info("待检查仓位已恢复，删除待检查记录: marketId=$marketId, outcomeIndex=$outcomeIndex, accountId=${copyTrading.accountId}, copyTradingId=${copyTrading.id}, elapsedTime=${System.currentTimeMillis() - pendingCheck.firstDetectedTime}ms")
                        }
                        // 有仓位，按订单下单顺序（FIFO）更新状态
-                        // 如果仓位数量 >= 订单数量总和，所有订单完全成交
+                        // 先查询创建时间超过2分钟的未匹配订单（SQL层过滤，避免刚创建的订单被误判）
-                        // 如果仓位数量 < 订单数量总和，按FIFO顺序部分成交
+                        val now = System.currentTimeMillis()
-                        val totalUnmatchedQuantity = orders.sumOf { it.remainingQuantity.toSafeBigDecimal() }
+                        val thresholdTime = now - 120000  // 2分钟 = 120000毫秒
                        val validOrders = copyOrderTrackingRepository.findUnmatchedBuyOrdersByOutcomeIndexOlderThan(
                            copyTradingId = copyTrading.id!!,
                            marketId = marketId,
                            outcomeIndex = outcomeIndex,
                            thresholdTime = thresholdTime
                        )
                        // 如果没有符合条件的订单，跳过处理
                        if (validOrders.isEmpty()) {
                            logger.debug("仓位存在但无符合条件的订单（创建时间不足2分钟），暂不进行FIFO匹配: marketId=$marketId, outcomeIndex=$outcomeIndex, thresholdTime=$thresholdTime")
                            continue
                        }
                        // 计算逻辑：
                         // 1. 总订单数量 = 所有符合条件的未卖出订单的剩余数量总和
                        // 2. 已成交数量 = 总订单数量 - 仓位数量（因为还有仓位，说明部分订单已卖出）
                        // 3. 如果已成交数量 = 0，说明订单还没有卖出，不修改订单状态
                        // 4. 如果已成交数量 > 0，按FIFO顺序匹配订单
                        val positionQuantity = position.quantity.toSafeBigDecimal()
                        // 计算总订单数量（只计算符合条件的订单）
                        val totalOrderQuantity = validOrders.fold(BigDecimal.ZERO) { sum, order ->
                            sum.add(order.remainingQuantity.toSafeBigDecimal())
                        }
                        // 计算已成交数量
                        val soldQuantity = totalOrderQuantity.subtract(positionQuantity)
                        // 如果已成交数量 <= 0，说明订单还没有卖出，不修改订单状态
                        if (soldQuantity <= BigDecimal.ZERO) {
                            continue
                        }
                        // 如果已成交数量 > 0，按FIFO顺序匹配订单（只匹配符合条件的订单）
                        try {
                        val currentPrice = getCurrentMarketPrice(marketId, outcomeIndex)
-                        updateOrdersAsSoldByFIFO(orders, positionQuantity, currentPrice, copyTrading.id!!, marketId, outcomeIndex)
+                        updateOrdersAsSoldByFIFO(validOrders, soldQuantity, currentPrice,
                            copyTrading.id, marketId, outcomeIndex)
                        } catch (e: Exception) {
                            logger.warn("无法获取市场价格，跳过FIFO匹配: marketId=$marketId, outcomeIndex=$outcomeIndex, error=${e.message}")
                            // 无法获取价格时，跳过该市场的处理，等待下次检查时再试
                            continue
                        }
                    }
                }
            }
@@ -387,25 +612,13 @@ class PositionCheckService(
    /**
     * 获取当前市场最新价（用于更新订单卖出价）
-     * 优先使用 bestBid（最优买价），如果没有则使用 midpoint（中间价）
+     * 委托给 MarketPriceService 处理
     */
    private suspend fun getCurrentMarketPrice(marketId: String, outcomeIndex: Int): BigDecimal {
-        return try {
+        return marketPriceService.getCurrentMarketPrice(marketId, outcomeIndex)
            val priceResult = accountService.getMarketPrice(marketId, outcomeIndex)
            val marketPrice = priceResult.getOrNull()
            if (marketPrice != null) {
                // 优先使用 bestBid（最优买价，用于卖出参考），如果没有则使用 midpoint
                val priceStr = marketPrice.bestBid ?: marketPrice.midpoint ?: marketPrice.lastPrice
                priceStr?.toSafeBigDecimal() ?: BigDecimal.ZERO
            } else {
                BigDecimal.ZERO
            }
        } catch (e: Exception) {
            logger.error("获取市场最新价失败: marketId=$marketId, outcomeIndex=$outcomeIndex, error=${e.message}", e)
            BigDecimal.ZERO
        }
    }
    /**
     * 在仓位赎回成功后，更新订单状态为已卖出
     * 使用卖出逻辑更新所有订单状态（未卖出订单的）
@@ -492,7 +705,8 @@ class PositionCheckService(
                    outcomeIndex = outcomeIndex,
                    totalMatchedQuantity = totalMatchedQuantity,
                    sellPrice = sellPrice,
-                    totalRealizedPnl = totalRealizedPnl
+                    totalRealizedPnl = totalRealizedPnl,
                    priceUpdated = true  // 自动生成的订单，直接标记为已处理，不发送通知
                )
                val savedRecord = sellMatchRecordRepository.save(matchRecord)
@@ -512,12 +726,22 @@ class PositionCheckService(
    /**
     * 按 FIFO 顺序更新订单状态为已卖出
-     * 仓位数量小于订单数量总和时，按订单下单顺序更新
+     * @param orders 订单列表（已按创建时间排序，FIFO）
-     * 同时创建卖出记录和匹配明细，用于统计
+     * @param soldQuantity 已成交数量（总订单数量 - 仓位数量）
     * @param sellPrice 卖出价格
     * @param copyTradingId 跟单配置ID
     * @param marketId 市场ID
     * @param outcomeIndex 结果索引
     * 
     * 逻辑说明：
     * 1. 按订单创建时间顺序（FIFO）处理
     * 2. 如果订单剩余数量 <= 已成交数量，订单完全成交
     * 3. 如果订单剩余数量 > 已成交数量，订单部分成交
     * 4. 同时创建卖出记录和匹配明细，用于统计
     */
    private suspend fun updateOrdersAsSoldByFIFO(
        orders: List<CopyOrderTracking>,
-        availableQuantity: BigDecimal,
+        soldQuantity: BigDecimal,
        sellPrice: BigDecimal,
        copyTradingId: Long,
        marketId: String,
@@ -529,7 +753,7 @@ class PositionCheckService(
        try {
            // 订单已经按 createdAt ASC 排序（FIFO）
-            var remaining = availableQuantity
+            var remaining = soldQuantity
            var totalMatchedQuantity = BigDecimal.ZERO
            var totalRealizedPnl = BigDecimal.ZERO
            val matchDetails = mutableListOf<SellMatchDetail>()
@@ -596,7 +820,8 @@ class PositionCheckService(
                    outcomeIndex = outcomeIndex,
                    totalMatchedQuantity = totalMatchedQuantity,
                    sellPrice = sellPrice,
-                    totalRealizedPnl = totalRealizedPnl
+                    totalRealizedPnl = totalRealizedPnl,
                    priceUpdated = true  // 自动生成的订单，直接标记为已处理，不发送通知
                )
                val savedRecord = sellMatchRecordRepository.save(matchRecord)
@@ -1,4 +1,4 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.accounts
 import com.wrbug.polymarketbot.dto.PositionListResponse
 import jakarta.annotation.PostConstruct
@@ -21,29 +21,29 @@ import java.util.concurrent.CopyOnWriteArrayList
 class PositionPollingService(
    private val accountService: AccountService
 ) {
-    
+
    private val logger = LoggerFactory.getLogger(PositionPollingService::class.java)
-    
+
    @Value("\${position.polling.interval:2000}")
    private var pollingInterval: Long = 2000  // 轮训间隔（毫秒），默认2秒
-    
+
    // 订阅者列表（支持多个订阅者）
    private val subscribers = CopyOnWriteArrayList<(PositionListResponse) -> Unit>()
-    
+
    // 最新仓位数据（用于丢弃机制）
    @Volatile
    private var latestPositions: PositionListResponse? = null
-    
+
    // 协程作用域和任务
    private val scope = CoroutineScope(Dispatchers.Default + SupervisorJob())
    private var pollingJob: Job? = null
-    
+
    // 事件分发协程（使用专门的线程，避免阻塞轮训）
    private val eventDispatcherScope = CoroutineScope(Dispatchers.IO + SupervisorJob())
-    
+
    // 同步锁，确保轮询任务的启动和停止是线程安全的
    private val lock = Any()
-    
+
    /**
     * 初始化服务（后端启动时直接启动轮训）
     */
@@ -52,7 +52,7 @@ class PositionPollingService(
        logger.info("PositionPollingService 初始化，启动仓位轮训任务，轮训间隔: ${pollingInterval}ms")
        startPolling()
    }
-    
+
    /**
     * 清理资源
     */
@@ -66,7 +66,7 @@ class PositionPollingService(
        scope.cancel()
        eventDispatcherScope.cancel()
    }
-    
+
    /**
     * 订阅仓位事件
     * @param callback 回调函数，接收最新的仓位数据
@@ -78,7 +78,7 @@ class PositionPollingService(
            latestPositions?.let { callback(it) }
        }
    }
-    
+
    /**
     * 取消订阅仓位事件
     */
@@ -87,7 +87,7 @@ class PositionPollingService(
            subscribers.remove(callback)
        }
    }
-    
+
    /**
     * 启动轮训任务
     */
@@ -95,7 +95,7 @@ class PositionPollingService(
        synchronized(lock) {
            // 如果已经有轮训任务在运行，先取消
            pollingJob?.cancel()
-            
+
            // 启动新的轮训任务
            pollingJob = scope.launch {
                while (isActive) {
@@ -109,7 +109,7 @@ class PositionPollingService(
            }
        }
    }
-    
+
    /**
     * 轮训仓位数据并发布事件
     * 使用专门的线程分发事件，避免阻塞轮训
@@ -123,7 +123,7 @@ class PositionPollingService(
                if (positions != null) {
                    // 更新最新数据（丢弃旧数据，只保留最新的）
                    latestPositions = positions
-                    
+
                    // 在专门的线程中分发事件，避免阻塞轮训
                    eventDispatcherScope.launch {
                        try {
@@ -131,7 +131,7 @@ class PositionPollingService(
                            val currentSubscribers = synchronized(lock) {
                                subscribers.toList()  // 复制列表，避免并发修改
                            }
-                            
+
                            currentSubscribers.forEach { callback ->
                                try {
                                    callback(positions)
@@ -139,8 +139,6 @@ class PositionPollingService(
                                    logger.error("通知订阅者失败: ${e.message}", e)
                                }
                            }
                            logger.debug("发布仓位数据事件: currentPositions=${positions.currentPositions.size}, historyPositions=${positions.historyPositions.size}, subscribers=${currentSubscribers.size}")
                        } catch (e: Exception) {
                            logger.error("分发仓位数据事件失败: ${e.message}", e)
                        }
@@ -1,6 +1,7 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.accounts
 import com.wrbug.polymarketbot.dto.AccountPositionDto
 import com.wrbug.polymarketbot.dto.PositionListResponse
 import com.wrbug.polymarketbot.dto.PositionPushMessage
 import com.wrbug.polymarketbot.dto.PositionPushMessageType
 import com.wrbug.polymarketbot.dto.getPositionKey
@@ -155,7 +156,7 @@ class PositionPushService(
     * 处理仓位更新事件
     * 根据文档要求：每次轮训完成后向订阅者发送全量数据
     */
-    private fun handlePositionUpdate(positions: com.wrbug.polymarketbot.dto.PositionListResponse) {
+    private fun handlePositionUpdate(positions: PositionListResponse) {
        // 更新快照
        lastCurrentPositions = positions.currentPositions.associateBy { it.getPositionKey() }
        lastHistoryPositions = positions.historyPositions.associateBy { it.getPositionKey() }
@@ -1,6 +1,7 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.announcement
 import com.wrbug.polymarketbot.api.GitHubApi
 import com.wrbug.polymarketbot.api.GitHubCommentResponse
 import com.wrbug.polymarketbot.dto.AnnouncementDto
 import com.wrbug.polymarketbot.dto.AnnouncementListResponse
 import com.wrbug.polymarketbot.util.RetrofitFactory
@@ -25,30 +26,30 @@ class AnnouncementService(
    @Value("\${github.announcement.issue.number:1}")
    private val issueNumber: Int
 ) {
-    
+
    private val logger = LoggerFactory.getLogger(AnnouncementService::class.java)
-    
+
    // GitHub API 客户端（懒加载）
    private val githubApi: GitHubApi by lazy {
        retrofitFactory.createGitHubApi()
    }
-    
+
    // 需要排除的 Issue ID（从 issue_url 中提取）
    private val excludedIssueId = "3703128976"
-    
+
    // 缓存数据（1分钟有效期）
    private data class CachedData<T>(
        val data: T,
        val timestamp: Long
    )
-    
+
    private var cachedList: CachedData<AnnouncementListResponse>? = null
    private var cachedAssignees: CachedData<List<String>>? = null
    private var cachedComments: CachedData<List<com.wrbug.polymarketbot.api.GitHubCommentResponse>>? = null
-    
+
    // 缓存有效期：10分钟（毫秒）
    private val cacheExpiryTime = 10 * 60 * 1000L
-    
+
    /**
     * 检查缓存是否有效
     */
@@ -57,7 +58,7 @@ class AnnouncementService(
        val now = System.currentTimeMillis()
        return (now - cached.timestamp) < cacheExpiryTime
    }
-    
+
    /**
     * 检查是否被限流
     */
@@ -70,7 +71,7 @@ class AnnouncementService(
        val remaining = response.headers()["X-RateLimit-Remaining"]
        return remaining == "0"
    }
-    
+
    /**
     * 获取 Issue 的 assignees 列表（通过 API 获取，带缓存）
     * @return Pair<assignees列表, 是否使用了缓存>
@@ -81,14 +82,14 @@ class AnnouncementService(
            logger.debug("使用缓存的 assignees")
            return Pair(cachedAssignees!!.data, true)
        }
-        
+
        return try {
            val response = githubApi.getIssue(
                owner = repoOwner,
                repo = repoName,
                issueNumber = issueNumber
            )
-            
+
            // 如果被限流，使用缓存数据，不更新缓存
            if (isRateLimited(response)) {
                logger.warn("GitHub API 被限流，使用缓存的 assignees（不更新缓存）")
@@ -98,14 +99,14 @@ class AnnouncementService(
                // 如果没有缓存，使用默认值
                return Pair(listOf("WrBug"), false)
            }
-            
+
            val assignees = if (response.isSuccessful && response.body() != null) {
                response.body()!!.assignees.map { it.login }
            } else {
                logger.warn("获取 Issue assignees 失败，使用默认值: code=${response.code()}")
                listOf("WrBug")  // 默认值
            }
-            
+
            // 更新缓存
            cachedAssignees = CachedData(assignees, System.currentTimeMillis())
            Pair(assignees, false)  // 返回新数据，标记为未使用缓存
@@ -119,24 +120,24 @@ class AnnouncementService(
            Pair(listOf("WrBug"), false)  // 默认值
        }
    }
-    
+
    /**
     * 获取 Issue 评论列表（带缓存）
     * @return Pair<评论列表, 是否使用了缓存>
     */
-    private suspend fun getIssueComments(forceRefresh: Boolean = false): Pair<List<com.wrbug.polymarketbot.api.GitHubCommentResponse>, Boolean> {
+    private suspend fun getIssueComments(forceRefresh: Boolean = false): Pair<List<GitHubCommentResponse>, Boolean> {
        // 检查缓存
        if (!forceRefresh && isCacheValid(cachedComments)) {
            logger.debug("使用缓存的评论列表")
            return Pair(cachedComments!!.data, true)
        }
-        
+
        val response = githubApi.getIssueComments(
            owner = repoOwner,
            repo = repoName,
            issueNumber = issueNumber
        )
-        
+
        // 如果被限流，使用缓存数据，不更新缓存
        if (isRateLimited(response)) {
            logger.warn("GitHub API 被限流，使用缓存的评论列表（不更新缓存）")
@@ -146,7 +147,7 @@ class AnnouncementService(
            // 如果没有缓存，抛出异常
            throw Exception("获取公告列表失败: GitHub API 被限流，且无缓存数据")
        }
-        
+
        if (!response.isSuccessful || response.body() == null) {
            logger.error("获取 GitHub Issue 评论失败: code=${response.code()}, message=${response.message()}")
            // 如果缓存存在，使用缓存
@@ -156,14 +157,14 @@ class AnnouncementService(
            }
            throw Exception("获取公告列表失败: HTTP ${response.code()}")
        }
-        
+
        val comments = response.body()!!
-        
+
        // 更新缓存
        cachedComments = CachedData(comments, System.currentTimeMillis())
        return Pair(comments, false)  // 返回新数据，标记为未使用缓存
    }
-    
+
    /**
     * 获取公告列表（最近10条）
     * @param forceRefresh 是否强制刷新缓存
@@ -174,12 +175,12 @@ class AnnouncementService(
            logger.debug("使用缓存的公告列表")
            return Result.success(cachedList!!.data)
        }
-        
+
        return try {
            // 强制刷新时，先尝试获取新数据
            val (assigneeList, assigneesFromCache) = getAssignees(forceRefresh)
            val (comments, commentsFromCache) = getIssueComments(forceRefresh)
-            
+
            // 如果强制刷新时使用了缓存（被限流），直接返回缓存数据，不更新缓存
            if (forceRefresh && (assigneesFromCache || commentsFromCache)) {
                logger.warn("强制刷新时被限流，返回缓存的公告列表（不更新缓存）")
@@ -187,48 +188,47 @@ class AnnouncementService(
                    return Result.success(cachedList!!.data)
                }
            }
-            
+
            // 筛选条件：
            // 1. assignees 发布的评论
            // 2. 排除 issueNumber 为 3703128976 的评论（从 issue_url 中提取）
-            val filteredComments = comments
+            val filteredComments = comments.filter { comment ->
-                .filter { comment ->
+                // 检查是否为 assignee
-                    // 检查是否为 assignee
+                val isAssignee = assigneeList.contains(comment.user.login)
-                    val isAssignee = assigneeList.contains(comment.user.login)
+
-                    
+                // 检查是否应该排除（从 issue_url 中提取 issue ID）
-                    // 检查是否应该排除（从 issue_url 中提取 issue ID）
+                val shouldExclude = comment.issue_url?.let { issueUrl ->
-                    val shouldExclude = comment.issue_url?.let { issueUrl ->
+                    // issue_url 格式：https://api.github.com/repos/owner/repo/issues/3703128976
-                        // issue_url 格式：https://api.github.com/repos/owner/repo/issues/3703128976
+                    // 提取最后的数字
-                        // 提取最后的数字
+                    val issueId = issueUrl.split("/").lastOrNull()
-                        val issueId = issueUrl.split("/").lastOrNull()
+                    issueId == excludedIssueId
-                        issueId == excludedIssueId
+                } ?: false
-                    } ?: false
+
-                    
+                isAssignee && !shouldExclude
-                    isAssignee && !shouldExclude
+            }
                }
                .sortedByDescending { comment ->
                    parseGitHubTime(comment.created_at)
                }
-            
+
            val total = filteredComments.size
            val hasMore = total > 10
-            
+
            // 取前10条
            val latest10 = filteredComments.take(10).map { comment ->
                toAnnouncementDto(comment)
            }
-            
+
            val result = AnnouncementListResponse(
                list = latest10,
                hasMore = hasMore,
                total = total
            )
-            
+
            // 只有在数据正常返回时才更新缓存（不是从缓存获取的）
            if (!assigneesFromCache && !commentsFromCache) {
                cachedList = CachedData(result, System.currentTimeMillis())
            }
-            
+
            Result.success(result)
        } catch (e: Exception) {
            logger.error("获取公告列表异常: ${e.message}", e)
@@ -240,7 +240,7 @@ class AnnouncementService(
            Result.failure(e)
        }
    }
-    
+
    /**
     * 获取公告详情
     * @param id 评论ID，如果为 null 则返回最新一条
@@ -249,19 +249,18 @@ class AnnouncementService(
    suspend fun getAnnouncementDetail(id: Long?, forceRefresh: Boolean = false): Result<AnnouncementDto> {
        return try {
            // 获取 assignees
-            val (assigneeList, assigneesFromCache) = getAssignees(forceRefresh)
+            val (assigneeList, _) = getAssignees(forceRefresh)
-            
+
            // 获取评论列表
-            val (comments, commentsFromCache) = getIssueComments(forceRefresh)
+            val (comments, _) = getIssueComments(forceRefresh)
-            
+
            // 筛选条件：
            // 1. assignees 发布的评论
            // 2. 排除 issueNumber 为 3703128976 的评论（从 issue_url 中提取）
-            val filteredComments = comments
+            val filteredComments = comments.filter { comment ->
                .filter { comment ->
                    // 检查是否为 assignee
                    val isAssignee = assigneeList.contains(comment.user.login)
-                    
+
                    // 检查是否应该排除（从 issue_url 中提取 issue ID）
                    val shouldExclude = comment.issue_url?.let { issueUrl ->
                        // issue_url 格式：https://api.github.com/repos/owner/repo/issues/3703128976
@@ -269,37 +268,37 @@ class AnnouncementService(
                        val issueId = issueUrl.split("/").lastOrNull()
                        issueId == excludedIssueId
                    } ?: false
-                    
+
                    isAssignee && !shouldExclude
                }
                .sortedByDescending { comment ->
                    parseGitHubTime(comment.created_at)
                }
-            
+
            val targetComment = if (id != null) {
                filteredComments.find { it.id == id }
            } else {
                filteredComments.firstOrNull()
            }
-            
+
            if (targetComment == null) {
                return Result.failure(IllegalArgumentException("公告不存在"))
            }
-            
+
            Result.success(toAnnouncementDto(targetComment))
        } catch (e: Exception) {
            logger.error("获取公告详情异常: ${e.message}", e)
            Result.failure(e)
        }
    }
-    
+
    /**
     * 将 GitHub 评论转换为 AnnouncementDto
     */
-    private fun toAnnouncementDto(comment: com.wrbug.polymarketbot.api.GitHubCommentResponse): AnnouncementDto {
+    private fun toAnnouncementDto(comment: GitHubCommentResponse): AnnouncementDto {
        // 提取标题（第一行，移除 Markdown 格式）
        val title = extractTitle(comment.body)
-        
+
        // 转换 reactions 数据
        val reactions = comment.reactions?.let { r ->
            com.wrbug.polymarketbot.dto.ReactionsDto(
@@ -314,7 +313,7 @@ class AnnouncementService(
                total = r.total_count
            )
        }
-        
+
        return AnnouncementDto(
            id = comment.id,
            title = title,
@@ -326,7 +325,7 @@ class AnnouncementService(
            reactions = reactions
        )
    }
-    
+
    /**
     * 从评论内容中提取标题（第一行，移除 Markdown 格式）
     * 支持的 Markdown 格式：
@@ -342,49 +341,49 @@ class AnnouncementService(
        if (body.isBlank()) {
            return ""
        }
-        
+
        // 获取第一行
        val firstLine = body.lines().firstOrNull()?.trim() ?: ""
        if (firstLine.isBlank()) {
            return ""
        }
-        
+
        // 移除 Markdown 格式
        var title = firstLine
-        
+
        // 移除标题标记（# ## ### 等）
        title = title.replace(Regex("^#{1,6}\\s+"), "")
-        
+
        // 移除粗体标记（**text** 或 __text__）
        title = title.replace(Regex("\\*\\*([^*]+)\\*\\*"), "$1")
        title = title.replace(Regex("__([^_]+)__"), "$1")
-        
+
        // 移除斜体标记（*text* 或 _text_）
        title = title.replace(Regex("(?<!\\*)\\*([^*]+)\\*(?!\\*)"), "$1")
        title = title.replace(Regex("(?<!_)_([^_]+)_(?!_)"), "$1")
-        
+
        // 移除代码标记（`code`）
        title = title.replace(Regex("`([^`]+)`"), "$1")
-        
+
        // 移除链接标记（[text](url)）
        title = title.replace(Regex("\\[([^\\]]+)\\]\\([^\\)]+\\)"), "$1")
-        
+
        // 移除图片标记（![alt](url)）
        title = title.replace(Regex("!\\[([^\\]]*)\\]\\([^\\)]+\\)"), "$1")
-        
+
        // 移除删除线标记（~~text~~）
        title = title.replace(Regex("~~([^~]+)~~"), "$1")
-        
+
        // 移除引用标记（> text）
        title = title.replace(Regex("^>\\s+"), "")
-        
+
        // 移除列表标记（- * + 1. 等）
        title = title.replace(Regex("^[-*+]\\s+"), "")
        title = title.replace(Regex("^\\d+\\.\\s+"), "")
-        
+
        return title.trim()
    }
-    
+
    /**
     * 解析 GitHub 时间格式（ISO 8601）为时间戳（毫秒）
     * GitHub API 返回的时间格式：2025-12-07T14:30:00Z
@@ -1,4 +1,4 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.auth
 import com.wrbug.polymarketbot.dto.CheckFirstUseResponse
 import com.wrbug.polymarketbot.dto.LoginResponse
@@ -10,6 +10,7 @@ import jakarta.servlet.http.HttpServletRequest
 import org.slf4j.LoggerFactory
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder
 import com.wrbug.polymarketbot.service.common.RateLimitService
 import org.springframework.stereotype.Service
 import org.springframework.transaction.annotation.Transactional
@@ -30,22 +31,44 @@ class AuthService(
    private lateinit var resetPasswordKey: String
    /**
-     * 登录
+     * 登录（带IP限速保护）
     */
-    fun login(username: String, password: String): Result<LoginResponse> {
+    fun login(username: String, password: String, ipAddress: String): Result<LoginResponse> {
        return try {
            // 检查登录频率限制
            rateLimitService.checkLoginRateLimit(ipAddress).fold(
                onSuccess = { },
                onFailure = { e ->
                    return Result.failure(IllegalStateException(e.message ?: "登录频率限制"))
                }
            )
            val user = userRepository.findByUsername(username)
-                ?: return Result.failure(IllegalArgumentException(ErrorCode.AUTH_USERNAME_OR_PASSWORD_ERROR.message))
+            if (user == null) {
-            
+                // 记录失败尝试
-            // 验证密码
+                val lockoutMsg = rateLimitService.recordLoginFailure(ipAddress)
-            if (!passwordEncoder.matches(password, user.password)) {
+                if (lockoutMsg != null) {
-                logger.warn("登录失败：密码错误，username=$username")
+                    return Result.failure(IllegalStateException(lockoutMsg))
                }
                return Result.failure(IllegalArgumentException(ErrorCode.AUTH_USERNAME_OR_PASSWORD_ERROR.message))
            }
-            
+
            // 验证密码
            if (!passwordEncoder.matches(password, user.password)) {
                // 记录失败尝试
                val lockoutMsg = rateLimitService.recordLoginFailure(ipAddress)
                if (lockoutMsg != null) {
                    return Result.failure(IllegalStateException(lockoutMsg))
                }
                return Result.failure(IllegalArgumentException(ErrorCode.AUTH_USERNAME_OR_PASSWORD_ERROR.message))
            }
            // 登录成功，清除失败记录
            rateLimitService.clearLoginFailures(ipAddress)
            // 生成JWT token（包含tokenVersion，用于使修改密码后的旧token失效）
            val token = jwtUtils.generateToken(username, user.tokenVersion)
-            
+
            logger.info("用户登录成功：username=$username")
            Result.success(LoginResponse(token = token))
        } catch (e: Exception) {
@@ -0,0 +1,93 @@
 package com.wrbug.polymarketbot.service.auth
 import org.springframework.scheduling.annotation.Scheduled
 import org.springframework.stereotype.Service
 import java.security.SecureRandom
 import java.util.concurrent.ConcurrentHashMap
 /**
 * WebSocket 票据服务
 * 用于生成短期有效的一次性票据，避免在 WebSocket URL 中暴露 JWT
 */
@Service
 class WebSocketTicketService {
    companion object {
        // 票据有效期（30秒）
        private const val TICKET_VALIDITY_MS = 30_000L
        // 票据长度（32字节 = 64个十六进制字符）
        private const val TICKET_LENGTH = 32
    }
    private val secureRandom = SecureRandom()
    // 存储票据：ticket -> TicketInfo
    private val tickets = ConcurrentHashMap<String, TicketInfo>()
    /**
     * 票据信息
     */
    data class TicketInfo(
        val username: String,
        val createdAt: Long,
        val expiresAt: Long
    )
    /**
     * 为用户生成 WebSocket 连接票据
     * @param username 用户名
     * @return 一次性票据
     */
    fun generateTicket(username: String): String {
        // 清理过期票据
        cleanupExpiredTickets()
        // 生成随机票据
        val bytes = ByteArray(TICKET_LENGTH)
        secureRandom.nextBytes(bytes)
        val ticket = bytes.joinToString("") { "%02x".format(it) }
        val now = System.currentTimeMillis()
        tickets[ticket] = TicketInfo(
            username = username,
            createdAt = now,
            expiresAt = now + TICKET_VALIDITY_MS
        )
        return ticket
    }
    /**
     * 验证并消费票据（一次性使用）
     * @param ticket 票据
     * @return 用户名，如果票据无效则返回 null
     */
    fun validateAndConsumeTicket(ticket: String): String? {
        val ticketInfo = tickets.remove(ticket) ?: return null
        // 检查是否过期
        if (System.currentTimeMillis() > ticketInfo.expiresAt) {
            return null
        }
        return ticketInfo.username
    }
    /**
     * 清理过期票据
     */
    private fun cleanupExpiredTickets() {
        val now = System.currentTimeMillis()
        tickets.entries.removeIf { it.value.expiresAt < now }
    }
    /**
     * 定时清理过期票据（每分钟执行一次）
     * 防止过期票据长时间占用内存
     */
    @Scheduled(fixedRate = 60_000)  // 60秒 = 60000毫秒
    fun scheduledCleanup() {
        cleanupExpiredTickets()
    }
 }
@@ -1,16 +1,19 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.common
 import com.google.gson.Gson
 import com.wrbug.polymarketbot.api.EthereumRpcApi
 import com.wrbug.polymarketbot.api.JsonRpcRequest
 import com.wrbug.polymarketbot.api.JsonRpcResponse
 import com.wrbug.polymarketbot.api.PolymarketDataApi
 import com.wrbug.polymarketbot.api.PositionResponse
 import com.wrbug.polymarketbot.api.ValueResponse
 import com.wrbug.polymarketbot.constants.PolymarketConstants
 import com.wrbug.polymarketbot.util.EthereumUtils
 import com.wrbug.polymarketbot.util.RetrofitFactory
 import com.wrbug.polymarketbot.util.createClient
 import org.slf4j.LoggerFactory
-import org.springframework.beans.factory.annotation.Value
+import com.wrbug.polymarketbot.service.system.RelayClientService
 import com.wrbug.polymarketbot.service.system.RpcNodeService
 import org.springframework.stereotype.Service
 import retrofit2.Retrofit
 import retrofit2.converter.gson.GsonConverterFactory
@@ -23,12 +26,10 @@ import java.math.BigInteger
 */
@Service
 class BlockchainService(
    @Value("\${polymarket.data-api.base-url:https://data-api.polymarket.com}")
    private val dataApiBaseUrl: String,
    @Value("\${polygon.rpc.url:}")
    private val polygonRpcUrl: String,
    private val retrofitFactory: RetrofitFactory,
-    private val relayClientService: RelayClientService
+    private val relayClientService: RelayClientService,
    private val rpcNodeService: RpcNodeService,
    private val gson: Gson
 ) {
    private val logger = LoggerFactory.getLogger(BlockchainService::class.java)
@@ -36,9 +37,16 @@ class BlockchainService(
    // USDC 合约地址（Polygon 主网，Polymarket 使用 Polygon）
    private val usdcContractAddress = "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174"
-    // Polymarket 代理工厂合约地址（Polygon 主网）
+    // Polymarket Safe 代理工厂合约地址（Polygon 主网，用于 MetaMask 用户）
    // 合约地址: 0xaacFeEa03eb1561C4e67d661e40682Bd20E3541b
-    private val proxyFactoryContractAddress = "0xaacFeEa03eb1561C4e67d661e40682Bd20E3541b"
+    private val safeProxyFactoryAddress = "0xaacFeEa03eb1561C4e67d661e40682Bd20E3541b"
    // Polymarket Magic 代理工厂合约地址（Polygon 主网，用于邮箱/OAuth 登录用户）
    // 合约地址: 0xaB45c5A4B0c941a2F231C04C3f49182e1A254052
    private val magicProxyFactoryAddress = "0xaB45c5A4B0c941a2F231C04C3f49182e1A254052"
    // Magic Proxy 的 init code hash（用于 CREATE2 计算）
    private val magicProxyInitCodeHash = "0xd21df8dc65880a8606f09fe0ce3df9b8869287ab0b058be05aa9e8af6330a00b"
    // ConditionalTokens 合约地址（Polygon 主网）
    private val conditionalTokensAddress = "0x4D97DCd97eC945f40cF65F87097ACe5EA0476045"
@@ -51,10 +59,10 @@ class BlockchainService(
    private val computeProxyAddressFunctionSignature = "computeProxyAddress(address)"
    private val dataApi: PolymarketDataApi by lazy {
-        val baseUrl = if (dataApiBaseUrl.endsWith("/")) {
+        val baseUrl = if (PolymarketConstants.DATA_API_BASE_URL.endsWith("/")) {
-            dataApiBaseUrl.dropLast(1)
+            PolymarketConstants.DATA_API_BASE_URL.dropLast(1)
        } else {
-            dataApiBaseUrl
+            PolymarketConstants.DATA_API_BASE_URL
        }
        val okHttpClient = createClient()
            .followRedirects(true)
@@ -63,79 +71,174 @@ class BlockchainService(
        Retrofit.Builder()
            .baseUrl("$baseUrl/")
            .client(okHttpClient)
-            .addConverterFactory(GsonConverterFactory.create())
+            .addConverterFactory(GsonConverterFactory.create(gson))
            .build()
            .create(PolymarketDataApi::class.java)
    }
-    private val polygonRpcApi: EthereumRpcApi? by lazy {
+    private val polygonRpcApi: EthereumRpcApi by lazy {
-        if (polygonRpcUrl.isBlank()) {
+        val rpcUrl = rpcNodeService.getHttpUrl()
-            null
+        retrofitFactory.createEthereumRpcApi(rpcUrl)
        } else {
            retrofitFactory.createEthereumRpcApi(polygonRpcUrl)
        }
    }
    /**
     * 获取 Polymarket 代理钱包地址
-     * 通过 RPC 调用代理工厂合约获取用户的代理钱包地址
+     * 根据指定的钱包类型返回对应的代理地址
     *
     * Polymarket 有两种代理钱包类型：
     * 1. Magic Proxy（邮箱/OAuth 登录用户）- 使用 CREATE2 计算地址
     * 2. Safe Proxy（MetaMask 钱包用户）- 通过合约调用获取地址
     *
     * @param walletAddress 用户的钱包地址（EOA）
     * @param walletType 钱包类型："magic"（默认）或 "safe"
     * @return 代理钱包地址
     */
    suspend fun getProxyAddress(walletAddress: String, walletType: String = "magic"): Result<String> {
        return try {
            when (walletType.lowercase()) {
                "safe" -> {
                    // Safe Proxy（MetaMask 用户）
                    val safeProxyResult = getSafeProxyAddress(walletAddress)
                    if (safeProxyResult.isSuccess) {
                        val safeProxyAddress = safeProxyResult.getOrNull()!!
                        logger.debug("使用 Safe Proxy 地址: $safeProxyAddress")
                        Result.success(safeProxyAddress)
                    } else {
                        Result.failure(safeProxyResult.exceptionOrNull() ?: Exception("获取 Safe Proxy 地址失败"))
                    }
                }
                else -> {
                    // Magic Proxy（邮箱/OAuth 登录用户）- 默认
                    val magicProxyAddress = calculateMagicProxyAddress(walletAddress)
                    logger.debug("使用 Magic Proxy 地址: $magicProxyAddress")
                    Result.success(magicProxyAddress)
                }
            }
        } catch (e: Exception) {
            logger.error("获取代理地址失败: ${e.message}", e)
            Result.failure(e)
        }
    }
    /**
     * 计算 Magic Proxy 地址（使用 CREATE2）
     * 用于邮箱/OAuth 登录的用户
     *
     * CREATE2 地址计算公式：
     * address = keccak256(0xff ++ factory ++ salt ++ initCodeHash)[12:]
     * salt = keccak256(eoaAddress)
     *
     * @param walletAddress 用户的钱包地址（EOA）
     * @return Magic 代理钱包地址
     */
    fun calculateMagicProxyAddress(walletAddress: String): String {
        // 计算 salt = keccak256(eoaAddress)
        val eoaBytes = EthereumUtils.hexToBytes(walletAddress.lowercase())
        val salt = EthereumUtils.keccak256(eoaBytes)
        // 计算 CREATE2 地址
        // data = 0xff ++ factory ++ salt ++ initCodeHash
        val prefix = byteArrayOf(0xff.toByte())
        val factoryBytes = EthereumUtils.hexToBytes(magicProxyFactoryAddress)
        val initCodeHashBytes = EthereumUtils.hexToBytes(magicProxyInitCodeHash)
        val data = prefix + factoryBytes + salt + initCodeHashBytes
        val hash = EthereumUtils.keccak256(data)
        // 取后 20 字节作为地址
        return "0x" + hash.copyOfRange(12, 32).joinToString("") { "%02x".format(it) }
    }
    /**
     * 获取 Safe Proxy 地址
     * 通过 RPC 调用 Safe 代理工厂合约获取用户的代理钱包地址
     * 用于 MetaMask 钱包用户
     *
     * @param walletAddress 用户的钱包地址
     * @return 代理钱包地址
     */
-    suspend fun getProxyAddress(walletAddress: String): Result<String> {
+    private suspend fun getSafeProxyAddress(walletAddress: String): Result<String> {
        return try {
-            // 如果未配置 RPC URL，返回错误
+            val rpcApi = polygonRpcApi
-            if (polygonRpcUrl.isBlank()) {
+
                logger.warn("未配置 Polygon RPC URL，无法获取代理地址")
                return Result.failure(IllegalStateException("未配置 Polygon RPC URL，无法获取代理地址。请在配置文件中设置 polygon.rpc.url 环境变量"))
            }
            val rpcApi = polygonRpcApi ?: throw IllegalStateException("Polygon RPC URL 未配置")
            // 计算函数选择器
            val functionSelector = EthereumUtils.getFunctionSelector(computeProxyAddressFunctionSignature)
            // 编码地址参数
            val encodedAddress = EthereumUtils.encodeAddress(walletAddress)
            // 构建调用数据
            val data = functionSelector + encodedAddress
-            
+
            // 构建 JSON-RPC 请求
            val rpcRequest = JsonRpcRequest(
                method = "eth_call",
                params = listOf(
                    mapOf(
-                        "to" to proxyFactoryContractAddress,
+                        "to" to safeProxyFactoryAddress,
                        "data" to data
                    ),
                    "latest"
                )
            )
-            
+
            // 发送 RPC 请求
            val response = rpcApi.call(rpcRequest)
-            
+
            if (!response.isSuccessful || response.body() == null) {
-                throw Exception("RPC 请求失败: ${response.code()} ${response.message()}")
+                return Result.failure(Exception("RPC 请求失败: ${response.code()} ${response.message()}"))
            }
-            
+
            val rpcResponse = response.body()!!
-            
+
            // 检查错误
            if (rpcResponse.error != null) {
-                throw Exception("RPC 错误: ${rpcResponse.error.message}")
+                return Result.failure(Exception("RPC 错误: ${rpcResponse.error.message}"))
            }
-            
+
-            val hexResult = rpcResponse.result ?: throw Exception("RPC 响应格式错误: result 为空")
+            // 使用 Gson 解析 result（JsonElement）
-            
+            val hexResult = rpcResponse.result?.asString
                ?: return Result.failure(Exception("RPC 响应格式错误: result 为空"))
            // 解析代理地址
            val proxyAddress = EthereumUtils.decodeAddress(hexResult)
-            
+
            Result.success(proxyAddress)
        } catch (e: Exception) {
            logger.error("获取代理地址失败: ${e.message}", e)
            Result.failure(e)
        }
    }
    /**
     * 检查地址是否是合约
     * @param address 地址
     * @return 如果地址有代码（是合约）返回 true
     */
    private suspend fun isContract(address: String): Boolean {
        return try {
            val rpcApi = polygonRpcApi
            val rpcRequest = JsonRpcRequest(
                method = "eth_getCode",
                params = listOf(address, "latest")
            )
            val response = rpcApi.call(rpcRequest)
            if (!response.isSuccessful || response.body() == null) {
                return false
            }
            val rpcResponse = response.body()!!
            if (rpcResponse.error != null) {
                return false
            }
            val code = rpcResponse.result?.asString ?: "0x"
            // 如果代码不是 "0x" 或 "0x0"，则是合约
            code != "0x" && code != "0x0"
        } catch (e: Exception) {
            logger.warn("检查合约地址失败: ${e.message}")
            false
        }
    }
    /**
     * 查询账户 USDC 余额
@@ -146,12 +249,6 @@ class BlockchainService(
     */
    suspend fun getUsdcBalance(walletAddress: String, proxyAddress: String): Result<String> {
        return try {
            // 如果未配置 RPC URL，返回错误
            if (polygonRpcUrl.isBlank()) {
                logger.warn("未配置 Polygon RPC URL，无法查询 USDC 余额")
                return Result.failure(IllegalStateException("未配置 Polygon RPC URL，无法查询 USDC 余额。请在配置文件中设置 polygon.rpc.url 环境变量"))
            }
            // 检查代理地址是否为空
            if (proxyAddress.isBlank()) {
                logger.error("代理地址为空，无法查询余额")
@@ -172,7 +269,7 @@ class BlockchainService(
     * 通过 RPC 查询 USDC 余额
     */
    private suspend fun queryUsdcBalanceViaRpc(walletAddress: String): String {
-        val rpcApi = polygonRpcApi ?: throw IllegalStateException("Polygon RPC URL 未配置")
+        val rpcApi = polygonRpcApi
        // 构建 ERC-20 balanceOf 函数调用
        // function signature: balanceOf(address) -> bytes4(0x70a08231)
@@ -207,7 +304,9 @@ class BlockchainService(
            throw Exception("RPC 错误: ${rpcResponse.error.message}")
        }
-        val hexBalance = rpcResponse.result ?: throw Exception("RPC 响应格式错误: result 为空")
+        // 使用 Gson 解析 result（JsonElement）
        val hexBalance = rpcResponse.result?.asString 
            ?: throw Exception("RPC 响应格式错误: result 为空")
        // 将十六进制转换为 BigDecimal（USDC 有 6 位小数）
        val balanceWei = BigInteger(hexBalance.removePrefix("0x"), 16)
@@ -263,13 +362,7 @@ class BlockchainService(
     */
    suspend fun getTokenId(conditionId: String, outcomeIndex: Int): Result<String> {
        return try {
-            // 如果未配置 RPC URL，返回错误
+            val rpcApi = polygonRpcApi
            if (polygonRpcUrl.isBlank()) {
                logger.warn("未配置 Polygon RPC URL，无法计算 tokenId")
                return Result.failure(IllegalStateException("未配置 Polygon RPC URL，无法计算 tokenId"))
            }
            val rpcApi = polygonRpcApi ?: throw IllegalStateException("Polygon RPC URL 未配置")
            // 验证 outcomeIndex
            if (outcomeIndex < 0) {
@@ -308,7 +401,9 @@ class BlockchainService(
                return Result.failure(Exception("调用 getCollectionId 失败: ${collectionIdResult.error}"))
            }
-            val collectionId = collectionIdResult.result ?: return Result.failure(Exception("getCollectionId 返回结果为空"))
+            // 使用 Gson 解析 result（JsonElement）
            val collectionId = collectionIdResult.result?.asString 
                ?: return Result.failure(Exception("getCollectionId 返回结果为空"))
            // 2. 调用 getPositionId(collateralToken, collectionId)
            val getPositionIdSelector = EthereumUtils.getFunctionSelector("getPositionId(address,bytes32)")
@@ -338,7 +433,9 @@ class BlockchainService(
                return Result.failure(Exception("调用 getPositionId 失败: ${positionIdResult.error}"))
            }
-            val tokenId = positionIdResult.result ?: return Result.failure(Exception("getPositionId 返回结果为空"))
+            // 使用 Gson 解析 result（JsonElement）
            val tokenId = positionIdResult.result?.asString 
                ?: return Result.failure(Exception("getPositionId 返回结果为空"))
            val tokenIdBigInt = EthereumUtils.decodeUint256(tokenId)
            Result.success(tokenIdBigInt.toString())
@@ -448,7 +545,7 @@ class BlockchainService(
     * 获取代理钱包的 nonce（用于构建 Safe 交易）
     */
    private suspend fun getProxyNonce(proxyAddress: String): Result<BigInteger> {
-        val rpcApi = polygonRpcApi ?: throw IllegalStateException("Polygon RPC URL 未配置")
+        val rpcApi = polygonRpcApi
        // Gnosis Safe 的 nonce 通过调用合约的 nonce() 函数获取
        val nonceFunctionSelector = EthereumUtils.getFunctionSelector("nonce()")
@@ -474,7 +571,9 @@ class BlockchainService(
            return Result.failure(Exception("获取 Proxy nonce 失败: ${rpcResponse.error.message}"))
        }
-        val hexNonce = rpcResponse.result ?: return Result.failure(Exception("Proxy nonce 结果为空"))
+        // 使用 Gson 解析 result（JsonElement）
        val hexNonce = rpcResponse.result?.asString 
            ?: return Result.failure(Exception("Proxy nonce 结果为空"))
        val nonce = EthereumUtils.decodeUint256(hexNonce)
        return Result.success(nonce)
    }
@@ -483,7 +582,7 @@ class BlockchainService(
     * 获取交易 nonce
     */
    private suspend fun getTransactionCount(address: String): Result<BigInteger> {
-        val rpcApi = polygonRpcApi ?: throw IllegalStateException("Polygon RPC URL 未配置")
+        val rpcApi = polygonRpcApi
        val rpcRequest = JsonRpcRequest(
            method = "eth_getTransactionCount",
@@ -502,7 +601,9 @@ class BlockchainService(
            return Result.failure(Exception("获取 nonce 失败: ${rpcResponse.error.message}"))
        }
-        val hexNonce = rpcResponse.result ?: return Result.failure(Exception("nonce 结果为空"))
+        // 使用 Gson 解析 result（JsonElement）
        val hexNonce = rpcResponse.result?.asString 
            ?: return Result.failure(Exception("nonce 结果为空"))
        val nonce = EthereumUtils.decodeUint256(hexNonce)
        return Result.success(nonce)
    }
@@ -511,7 +612,7 @@ class BlockchainService(
     * 获取 gas price
     */
    private suspend fun getGasPrice(): Result<BigInteger> {
-        val rpcApi = polygonRpcApi ?: throw IllegalStateException("Polygon RPC URL 未配置")
+        val rpcApi = polygonRpcApi
        val rpcRequest = JsonRpcRequest(
            method = "eth_gasPrice",
@@ -528,7 +629,9 @@ class BlockchainService(
            return Result.failure(Exception("获取 gas price 失败: ${rpcResponse.error.message}"))
        }
-        val hexGasPrice = rpcResponse.result ?: return Result.failure(Exception("gas price 结果为空"))
+        // 使用 Gson 解析 result（JsonElement）
        val hexGasPrice = rpcResponse.result?.asString 
            ?: return Result.failure(Exception("gas price 结果为空"))
        val gasPrice = EthereumUtils.decodeUint256(hexGasPrice)
        return Result.success(gasPrice)
    }
@@ -602,10 +705,166 @@ class BlockchainService(
            return Result.failure(Exception("发送交易失败: ${rpcResponse.error.message}"))
        }
-        val txHash = rpcResponse.result ?: return Result.failure(Exception("交易哈希为空"))
+        // 使用 Gson 解析 result（JsonElement）
        val txHash = rpcResponse.result?.asString 
            ?: return Result.failure(Exception("交易哈希为空"))
        return Result.success(txHash)
    }
    /**
     * 从链上查询市场条件（Condition）的结算结果
     * 通过调用 ConditionalTokens 合约的 conditions mapping 和 payoutNumerators mapping
     * 
     * @param conditionId 市场条件ID（bytes32，必须是 0x 开头的 66 位十六进制字符串）
     * @return Result<Pair<payoutDenominator, payouts>>
     *   - payoutDenominator: 支付分母（通常为 1）
     *   - payouts: 每个 outcome 的支付金额数组（0 或 1）
     *   - 如果 payouts[outcomeIndex] == 1，表示该 outcome 赢了
     *   - 如果 payouts[outcomeIndex] == 0，表示该 outcome 输了
     *   - 如果 payouts 为空，表示市场尚未结算
     */
    suspend fun getCondition(conditionId: String): Result<Pair<BigInteger, List<BigInteger>>> {
        return try {
            // 验证 conditionId 格式
            if (conditionId.isBlank() || !conditionId.startsWith("0x") || conditionId.length != 66) {
                return Result.failure(IllegalArgumentException("conditionId 格式错误，必须是 0x 开头的 66 位十六进制字符串"))
            }
            val rpcApi = polygonRpcApi
            // 1. 调用 getOutcomeSlotCount(bytes32) 获取结果槽位数量
            // 函数签名: getOutcomeSlotCount(bytes32) returns (uint)
            val getOutcomeSlotCountSelector = EthereumUtils.getFunctionSelector("getOutcomeSlotCount(bytes32)")
            val encodedConditionId = EthereumUtils.encodeBytes32(conditionId)
            val outcomeSlotCountData = getOutcomeSlotCountSelector + encodedConditionId
            val outcomeSlotCountRequest = JsonRpcRequest(
                method = "eth_call",
                params = listOf(
                    mapOf(
                        "to" to conditionalTokensAddress,
                        "data" to outcomeSlotCountData
                    ),
                    "latest"
                )
            )
            val outcomeSlotCountResponse = rpcApi.call(outcomeSlotCountRequest)
            if (!outcomeSlotCountResponse.isSuccessful || outcomeSlotCountResponse.body() == null) {
                return Result.failure(Exception("RPC 请求失败 (getOutcomeSlotCount): ${outcomeSlotCountResponse.code()} ${outcomeSlotCountResponse.message()}"))
            }
            val outcomeSlotCountRpcResponse = outcomeSlotCountResponse.body()!!
            if (outcomeSlotCountRpcResponse.error != null) {
                val errorMsg = "RPC 错误 (code=${outcomeSlotCountRpcResponse.error.code}): ${outcomeSlotCountRpcResponse.error.message}, data=${outcomeSlotCountRpcResponse.error.data}"
                logger.warn("查询市场条件(getOutcomeSlotCount)出现RPC错误: conditionId=$conditionId, $errorMsg")
                logger.debug("RPC 请求详情: to=$conditionalTokensAddress, data=$outcomeSlotCountData")
                return Result.failure(Exception(errorMsg))
            }
            val outcomeSlotCountHex = outcomeSlotCountRpcResponse.result?.asString 
                ?: return Result.failure(Exception("RPC 响应格式错误: result 为空"))
            val outcomeSlotCount = EthereumUtils.decodeUint256(outcomeSlotCountHex).toInt()
            // 如果 outcomeSlotCount 为 0，说明市场尚未创建或不存在
            if (outcomeSlotCount <= 0) {
                logger.debug("市场尚未创建或不存在: conditionId=$conditionId, outcomeSlotCount=$outcomeSlotCount")
                return Result.success(Pair(BigInteger.ZERO, emptyList()))
            }
            // 2. 调用 payoutDenominator(bytes32) 获取分母
            // 函数签名: payoutDenominator(bytes32) returns (uint)
            val payoutDenominatorSelector = EthereumUtils.getFunctionSelector("payoutDenominator(bytes32)")
            val payoutDenominatorData = payoutDenominatorSelector + encodedConditionId
            val payoutDenominatorRequest = JsonRpcRequest(
                method = "eth_call",
                params = listOf(
                    mapOf(
                        "to" to conditionalTokensAddress,
                        "data" to payoutDenominatorData
                    ),
                    "latest"
                )
            )
            val payoutDenominatorResponse = rpcApi.call(payoutDenominatorRequest)
            if (!payoutDenominatorResponse.isSuccessful || payoutDenominatorResponse.body() == null) {
                return Result.failure(Exception("RPC 请求失败 (payoutDenominator): ${payoutDenominatorResponse.code()} ${payoutDenominatorResponse.message()}"))
            }
            val payoutDenominatorRpcResponse = payoutDenominatorResponse.body()!!
            if (payoutDenominatorRpcResponse.error != null) {
                val errorMsg = "RPC 错误 (code=${payoutDenominatorRpcResponse.error.code}): ${payoutDenominatorRpcResponse.error.message}, data=${payoutDenominatorRpcResponse.error.data}"
                logger.warn("查询市场条件(payoutDenominator)出现RPC错误: conditionId=$conditionId, $errorMsg")
                logger.debug("RPC 请求详情: to=$conditionalTokensAddress, data=$payoutDenominatorData")
                return Result.failure(Exception(errorMsg))
            }
            val payoutDenominatorHex = payoutDenominatorRpcResponse.result?.asString 
                ?: return Result.failure(Exception("RPC 响应格式错误: result 为空"))
            val payoutDenominator = EthereumUtils.decodeUint256(payoutDenominatorHex)
            // 如果 outcomeSlotCount 为 0，说明市场尚未创建或不存在
            if (outcomeSlotCount <= 0) {
                logger.debug("市场尚未创建或不存在: conditionId=$conditionId, outcomeSlotCount=$outcomeSlotCount")
                return Result.success(Pair(BigInteger.ZERO, emptyList()))
            }
            // 如果 payoutDenominator 为 0，说明市场尚未结算
            if (payoutDenominator == BigInteger.ZERO) {
                logger.debug("市场尚未结算: conditionId=$conditionId, payoutDenominator=$payoutDenominator")
                return Result.success(Pair(BigInteger.ZERO, emptyList()))
            }
            // 2. 查询每个 outcome 的 payoutNumerators
            val payouts = mutableListOf<BigInteger>()
            for (i in 0 until outcomeSlotCount) {
                val payoutNumeratorsFunctionSelector = EthereumUtils.getFunctionSelector("payoutNumerators(bytes32,uint256)")
                val encodedIndex = EthereumUtils.encodeUint256(BigInteger.valueOf(i.toLong()))
                val payoutNumeratorsData = payoutNumeratorsFunctionSelector + encodedConditionId + encodedIndex
                val payoutRequest = JsonRpcRequest(
                    method = "eth_call",
                    params = listOf(
                        mapOf(
                            "to" to conditionalTokensAddress,
                            "data" to payoutNumeratorsData
                        ),
                        "latest"
                    )
                )
                val payoutResponse = rpcApi.call(payoutRequest)
                if (!payoutResponse.isSuccessful || payoutResponse.body() == null) {
                    logger.warn("查询 payoutNumerators 失败: index=$i")
                    continue
                }
                val payoutRpcResponse = payoutResponse.body()!!
                if (payoutRpcResponse.error != null) {
                    logger.warn("查询 payoutNumerators 错误: index=$i, error=${payoutRpcResponse.error.message}")
                    continue
                }
                val payoutHex = payoutRpcResponse.result?.asString ?: "0x0"
                val payout = EthereumUtils.decodeUint256(payoutHex)
                payouts.add(payout)
            }
            Result.success(Pair(payoutDenominator, payouts))
        } catch (e: Exception) {
            logger.error("查询市场条件失败: conditionId=$conditionId, ${e.message}", e)
            Result.failure(e)
        }
    }
    /**
     * 查询交易详情（用于调试和分析）
     * @param txHash 交易哈希
@@ -613,11 +872,7 @@ class BlockchainService(
     */
    suspend fun getTransactionDetails(txHash: String): Result<String> {
        return try {
-            if (polygonRpcUrl.isBlank()) {
+            val rpcApi = polygonRpcApi
                return Result.failure(IllegalStateException("未配置 Polygon RPC URL"))
            }
            val rpcApi = polygonRpcApi ?: throw IllegalStateException("Polygon RPC URL 未配置")
            // 查询交易
            val txRequest = JsonRpcRequest(
@@ -635,7 +890,9 @@ class BlockchainService(
                return Result.failure(Exception("查询交易失败: ${txRpcResponse.error.message}"))
            }
-            val txResult = txRpcResponse.result ?: return Result.failure(Exception("交易结果为空"))
+            // 使用 Gson 解析 result（JsonElement）
            val txResult = txRpcResponse.result?.toString() 
                ?: return Result.failure(Exception("交易结果为空"))
            // 查询交易回执（包含内部调用和事件日志）
            val receiptRequest = JsonRpcRequest(
@@ -652,7 +909,7 @@ class BlockchainService(
            val receiptResult = if (receiptRpcResponse.error != null) {
                "交易回执查询失败: ${receiptRpcResponse.error.message}"
            } else {
-                receiptRpcResponse.result ?: "交易回执为空（可能还在打包中）"
+                receiptRpcResponse.result?.toString() ?: "交易回执为空（可能还在打包中）"
            }
            Result.success("交易信息:\n$txResult\n\n交易回执:\n$receiptResult")
@@ -0,0 +1,167 @@
 package com.wrbug.polymarketbot.service.common
 import com.wrbug.polymarketbot.repository.CopyOrderTrackingRepository
 import jakarta.annotation.PostConstruct
 import jakarta.annotation.PreDestroy
 import kotlinx.coroutines.*
 import org.slf4j.LoggerFactory
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.stereotype.Service
 /**
 * 市场信息轮询服务
 * 定期检查买入订单的市场信息是否缺失，如果缺失则从API获取并更新
 */
@Service
 class MarketPollingService(
    private val copyOrderTrackingRepository: CopyOrderTrackingRepository,
    private val marketService: MarketService
 ) {
    private val logger = LoggerFactory.getLogger(MarketPollingService::class.java)
    @Value("\${market.polling.interval:30000}")
    private var pollingInterval: Long = 30000  // 轮询间隔（毫秒），默认30秒
    @Value("\${market.polling.batch.size:50}")
    private var batchSize: Int = 50  // 批量处理大小，每次最多处理50个市场
    // 协程作用域和任务
    private val scope = CoroutineScope(Dispatchers.Default + SupervisorJob())
    private var pollingJob: Job? = null
    // 同步锁，确保轮询任务的启动和停止是线程安全的
    private val lock = Any()
    /**
     * 初始化服务（后端启动时直接启动轮询）
     */
    @PostConstruct
    fun init() {
        logger.info("MarketPollingService 初始化，启动市场信息轮询任务，轮询间隔: ${pollingInterval}ms (${pollingInterval / 1000 / 60}分钟)")
        startPolling()
    }
    /**
     * 清理资源
     */
    @PreDestroy
    fun destroy() {
        synchronized(lock) {
            pollingJob?.cancel()
            pollingJob = null
        }
        scope.cancel()
    }
    /**
     * 启动轮询任务
     */
    private fun startPolling() {
        synchronized(lock) {
            // 如果已经有轮询任务在运行，先取消
            pollingJob?.cancel()
            // 启动新的轮询任务
            pollingJob = scope.launch(Dispatchers.IO) {
                // 启动时立即执行一次
                try {
                    checkAndUpdateMissingMarkets()
                } catch (e: Exception) {
                    logger.error("初始检查市场信息失败: ${e.message}", e)
                }
                // 然后按间隔定期执行
                while (isActive) {
                    try {
                        delay(pollingInterval)
                        checkAndUpdateMissingMarkets()
                    } catch (e: Exception) {
                        logger.error("轮询市场信息失败: ${e.message}", e)
                    }
                }
            }
        }
    }
    /**
     * 检查并更新缺失的市场信息
     */
    private suspend fun checkAndUpdateMissingMarkets() {
        try {
            // 1. 获取所有买入订单的市场ID（去重）
            val allOrders = copyOrderTrackingRepository.findAll()
            val marketIds = allOrders.map { it.marketId }.distinct()
            if (marketIds.isEmpty()) {
                logger.debug("没有找到任何订单，跳过市场信息检查")
                return
            }
            // 2. 检查哪些市场信息在数据库中缺失
            val existingMarkets = marketService.marketRepository.findByMarketIdIn(marketIds)
            val existingMarketIds = existingMarkets.map { it.marketId }.toSet()
            val missingMarketIds = marketIds.filter { it !in existingMarketIds }
            // 过滤掉空字符串和无效的市场ID
            val validMissingMarketIds = missingMarketIds.filter { 
                it.isNotBlank() && it.startsWith("0x") 
            }
            if (validMissingMarketIds.isEmpty()) {
                return
            }
            logger.info("发现 ${validMissingMarketIds.size} 个缺失的市场信息，开始批量更新...")
            // 3. 批量从API获取缺失的市场信息（分批处理，避免一次性请求过多）
            val batches = validMissingMarketIds.chunked(batchSize)
            var successCount = 0
            var failCount = 0
            for ((index, batch) in batches.withIndex()) {
                try {
                    logger.debug("处理第 ${index + 1}/${batches.size} 批，包含 ${batch.size} 个市场: ${batch.take(3).joinToString(", ")}${if (batch.size > 3) "..." else ""}")
                    // 使用 MarketService 的批量获取方法
                    // 这个方法会尝试从API获取并保存到数据库
                    val markets = marketService.getMarkets(batch)
                    val batchSuccessCount = markets.size
                    val batchFailCount = batch.size - batchSuccessCount
                    successCount += batchSuccessCount
                    failCount += batchFailCount
                    if (batchFailCount > 0) {
                        logger.warn("第 ${index + 1} 批中有 ${batchFailCount} 个市场信息获取失败")
                    }
                    // 避免请求过于频繁，每批之间稍作延迟
                    if (index < batches.size - 1) {
                        delay(1000)  // 延迟1秒，避免API限流
                    }
                } catch (e: Exception) {
                    logger.error("批量获取市场信息失败: batch=${batch.take(5).joinToString(", ")}..., error=${e.message}", e)
                    failCount += batch.size
                }
            }
            logger.info("市场信息更新完成: 成功=${successCount}, 失败=${failCount}, 总计=${validMissingMarketIds.size}")
        } catch (e: Exception) {
            logger.error("检查并更新市场信息异常: ${e.message}", e)
        }
    }
    /**
     * 手动触发检查（用于测试或手动刷新）
     */
    fun triggerCheck() {
        scope.launch(Dispatchers.IO) {
            try {
                checkAndUpdateMissingMarkets()
            } catch (e: Exception) {
                logger.error("手动触发检查市场信息失败: ${e.message}", e)
            }
        }
    }
 }
@@ -0,0 +1,294 @@
 package com.wrbug.polymarketbot.service.common
 import com.wrbug.polymarketbot.api.PolymarketClobApi
 import com.wrbug.polymarketbot.repository.AccountRepository
 import com.wrbug.polymarketbot.util.CryptoUtils
 import com.wrbug.polymarketbot.util.RetrofitFactory
 import com.wrbug.polymarketbot.util.toSafeBigDecimal
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
 import java.math.BigDecimal
 import java.math.BigInteger
 /**
 * 市场价格服务
 * 统一封装从不同数据源获取市场价格的逻辑
 * 数据源包括：
 * 1. 链上 RPC 查询（市场结算结果）
 * 2. CLOB API（订单簿价格）
 */
@Service
 class MarketPriceService(
    private val blockchainService: BlockchainService,
    private val retrofitFactory: RetrofitFactory,
    private val accountRepository: AccountRepository,
    private val cryptoUtils: CryptoUtils
 ) {
    private val logger = LoggerFactory.getLogger(MarketPriceService::class.java)
    /**
     * 获取当前市场最新价
     * 优先级：
     * 1. 链上查询市场结算结果（如果已结算，返回 1.0 或 0.0）
     * 2. CLOB API 查询订单簿价格（最准确，优先使用，使用 bestBid）
     * 3. Gamma Market API 查询市场价格（快速，作为备选）
     * 
     * 价格会被截位到 4 位小数（向下截断，不四舍五入），用于显示和后续计算
     * 
     * @param marketId 市场ID
     * @param outcomeIndex 结果索引
     * @return 市场价格（已截位到 4 位小数）
     * @throws IllegalStateException 如果所有数据源都失败
     */
    suspend fun getCurrentMarketPrice(marketId: String, outcomeIndex: Int): BigDecimal {
        // 1. 优先从链上查询市场结算结果
        val (chainPrice, hasRpcError) = getPriceFromChainCondition(marketId, outcomeIndex)
        if (chainPrice != null) {
            // 截位到 4 位小数（向下截断，不四舍五入）
            return chainPrice.setScale(4, java.math.RoundingMode.DOWN)
        }
        // 如果链上查询出现 RPC 错误（execution reverted），说明市场可能不存在或尚未创建
        // 在这种情况下，降级到其他数据源（CLOB API 或 Gamma API），而不是直接抛出异常
        // 因为 marketId 可能在 API 中存在，但在链上尚未创建
        if (hasRpcError) {
            logger.debug("链上查询市场条件出现 RPC 错误（execution reverted），降级到 API 查询: marketId=$marketId, outcomeIndex=$outcomeIndex")
        }
        // 2. 从 CLOB API 查询订单簿价格（最准确，优先使用）
        val orderbookPrice = getPriceFromClobOrderbook(marketId, outcomeIndex)
        if (orderbookPrice != null) {
            // 截位到 4 位小数（向下截断，不四舍五入）
            return orderbookPrice.setScale(4, java.math.RoundingMode.DOWN)
        }
        // 3. 从 Gamma Market API 查询市场价格（作为备选）
        val marketPrice = getPriceFromGammaMarket(marketId, outcomeIndex)
        if (marketPrice != null) {
            // 截位到 4 位小数（向下截断，不四舍五入）
            return marketPrice.setScale(4, java.math.RoundingMode.DOWN)
        }
        // 如果所有数据源都失败，抛出异常
        val errorMsg = "无法获取市场价格: marketId=$marketId, outcomeIndex=$outcomeIndex (链上查询、订单簿查询和 Market API 均失败)"
        logger.error(errorMsg)
        throw IllegalStateException(errorMsg)
    }
    /**
     * 从链上查询市场结算结果获取价格
     * 如果市场已结算：
     *   - payout > 0（赢了）→ 返回 1.0
     *   - payout == 0（输了）→ 返回 0.0
     * 如果市场未结算或查询失败，返回 null
     * 
     * @return Pair<BigDecimal?, Boolean> 第一个值是价格（如果已结算），第二个值表示是否发生了 RPC 错误（execution reverted）
     */
    private suspend fun getPriceFromChainCondition(marketId: String, outcomeIndex: Int): Pair<BigDecimal?, Boolean> {
        return try {
            val chainResult = blockchainService.getCondition(marketId)
            chainResult.fold(
                onSuccess = { (_, payouts) ->
                    // 如果 payouts 不为空，说明市场已结算
                    if (payouts.isNotEmpty() && outcomeIndex < payouts.size) {
                        val payout = payouts[outcomeIndex]
                        when {
                            payout > BigInteger.ZERO -> {
                                logger.info("从链上查询到市场已结算，该 outcome 赢了: marketId=$marketId, outcomeIndex=$outcomeIndex, payout=$payout")
                                return Pair(BigDecimal.ONE, false)
                            }
                            payout == BigInteger.ZERO -> {
                                logger.info("从链上查询到市场已结算，该 outcome 输了: marketId=$marketId, outcomeIndex=$outcomeIndex, payout=$payout")
                                return Pair(BigDecimal.ZERO, false)
                            }
                            else -> {
                                logger.warn("从链上查询到异常的 payout 值: marketId=$marketId, outcomeIndex=$outcomeIndex, payout=$payout")
                                Pair(null, false)
                            }
                        }
                    } else {
                        logger.debug("从链上查询到市场尚未结算: marketId=$marketId, payouts=${payouts.size}")
                        Pair(null, false)
                    }
                },
                onFailure = { e ->
                    // 检查是否是 execution reverted 错误
                    val isRpcError = e.message?.contains("execution reverted", ignoreCase = true) == true
                    if (isRpcError) {
                        logger.warn("链上查询市场条件出现 RPC 错误（execution reverted），可能市场不存在或尚未创建: marketId=$marketId, error=${e.message}")
                    } else {
                    logger.debug("链上查询市场条件失败，降级到 API 查询: marketId=$marketId, error=${e.message}")
                    }
                    Pair(null, isRpcError)
                }
            )
        } catch (e: Exception) {
            val isRpcError = e.message?.contains("execution reverted", ignoreCase = true) == true
            if (isRpcError) {
                logger.warn("链上查询市场条件异常（execution reverted）: marketId=$marketId, outcomeIndex=$outcomeIndex, error=${e.message}")
            } else {
            logger.debug("链上查询市场条件异常: marketId=$marketId, outcomeIndex=$outcomeIndex, error=${e.message}")
            }
            Pair(null, isRpcError)
        }
    }
    /**
     * 从 Gamma Market API 获取价格
     * 使用 outcomePrices 字段，格式通常为 JSON 字符串 "[\"0.5\", \"0.5\"]"
     * 如果查询失败或 outcomePrices 为空，返回 null
     */
    private suspend fun getPriceFromGammaMarket(marketId: String, outcomeIndex: Int): BigDecimal? {
        return try {
            val gammaApi = retrofitFactory.createGammaApi()
            val marketResponse = gammaApi.listMarkets(conditionIds = listOf(marketId))
            if (!marketResponse.isSuccessful || marketResponse.body() == null) {
                logger.debug("Gamma Market API 查询失败: marketId=$marketId, code=${marketResponse.code()}")
                return null
            }
            val markets = marketResponse.body()!!
            if (markets.isEmpty()) {
                logger.debug("Gamma Market API 未找到市场: marketId=$marketId")
                return null
            }
            val market = markets.first()
            // 尝试从 outcomePrices 字段获取价格
            val outcomePricesStr = market.outcomePrices
            if (outcomePricesStr.isNullOrBlank()) {
                logger.debug("Market outcomePrices 为空: marketId=$marketId")
                return null
            }
            // 解析 outcomePrices（通常是 JSON 数组字符串）
            val outcomePrices = try {
                // 移除首尾的方括号和引号，按逗号分割
                val cleanStr = outcomePricesStr.trim().removeSurrounding("[", "]")
                cleanStr.split(",").map { 
                    it.trim().removeSurrounding("\"").toSafeBigDecimal() 
                }
            } catch (e: Exception) {
                logger.warn("解析 outcomePrices 失败: marketId=$marketId, outcomePrices=$outcomePricesStr, error=${e.message}")
                null
            }
            if (outcomePrices != null && outcomeIndex < outcomePrices.size) {
                val price = outcomePrices[outcomeIndex]
                logger.debug("从 Gamma Market API 获取价格: marketId=$marketId, outcomeIndex=$outcomeIndex, price=$price")
                return price
            }
            null
        } catch (e: Exception) {
            logger.debug("Gamma Market API 查询异常: marketId=$marketId, outcomeIndex=$outcomeIndex, error=${e.message}")
            null
        }
    }
    /**
     * 从 CLOB API 查询订单簿价格
     * 获取订单簿的 bestBid 和 bestAsk，计算 midpoint = (bestBid + bestAsk) / 2
     * 订单簿数据最准确，反映当前市场真实价格
     * 如果查询失败，返回 null
     */
    private suspend fun getPriceFromClobOrderbook(marketId: String, outcomeIndex: Int): BigDecimal? {
        return try {
            // 获取 tokenId（用于查询特定 outcome 的订单簿）
            val tokenIdResult = blockchainService.getTokenId(marketId, outcomeIndex)
            if (!tokenIdResult.isSuccess) {
                return null
            }
            val tokenId = tokenIdResult.getOrNull() ?: return null
            // 尝试使用带鉴权的 CLOB API，如果没有则使用不带鉴权的 API
            val clobApi = try {
                getAuthenticatedClobApi() ?: retrofitFactory.createClobApiWithoutAuth()
            } catch (e: Exception) {
                logger.debug("获取带鉴权的 CLOB API 失败，使用不带鉴权的 API: ${e.message}")
                retrofitFactory.createClobApiWithoutAuth()
            }
            val orderbookResponse = clobApi.getOrderbook(tokenId = tokenId, market = null)
            if (!orderbookResponse.isSuccessful || orderbookResponse.body() == null) {
                return null
            }
            val orderbook = orderbookResponse.body()!!
            // 获取 bestBid（最高买入价）：从 bids 中找到价格最大的
            // bids 表示买入订单列表，价格越高表示愿意出的价格越高
            val bestBid = orderbook.bids
                .mapNotNull { it.price.toSafeBigDecimal() }
                .maxOrNull()
            // 获取 bestAsk（最低卖出价）：从 asks 中找到价格最小的
            // asks 表示卖出订单列表，价格越低表示愿意卖的价格越低
            val bestAsk = orderbook.asks
                .mapNotNull { it.price.toSafeBigDecimal() }
                .minOrNull()
            // 由于主要用于卖出场景，优先使用 bestBid（最高买入价，卖给愿意买入的人）
            // 如果没有 bestBid，则使用 midpoint 或 bestAsk
            if (bestBid != null) {
                logger.debug("从订单簿获取价格（bestBid）: marketId=$marketId, outcomeIndex=$outcomeIndex, bestBid=$bestBid, bestAsk=$bestAsk")
                return bestBid
            } else if (bestAsk != null && bestAsk > BigDecimal.ZERO) {
                // 如果没有 bestBid，使用 bestAsk 作为备选
                logger.debug("从订单簿获取价格（bestAsk）: marketId=$marketId, outcomeIndex=$outcomeIndex, bestAsk=$bestAsk")
                return bestAsk
            }
            null
        } catch (e: Exception) {
            logger.debug("CLOB API 查询订单簿失败: marketId=$marketId, outcomeIndex=$outcomeIndex, error=${e.message}")
            null
        }
    }
    /**
     * 获取带鉴权的 CLOB API 客户端
     * 使用第一个有 API 凭证的账户
     * 如果都没有，返回 null
     */
    private fun getAuthenticatedClobApi(): PolymarketClobApi? {
        return try {
            // 使用第一个有 API 凭证的账户
            val account = accountRepository.findAllByOrderByCreatedAtAsc()
                .firstOrNull { it.apiKey != null && it.apiSecret != null && it.apiPassphrase != null }
            if (account == null || account.apiKey == null || account.apiSecret == null || account.apiPassphrase == null) {
                return null
            }
            // 解密 API 凭证
            val apiKey = account.apiKey
            val apiSecret = try {
                cryptoUtils.decrypt(account.apiSecret)
            } catch (e: Exception) {
                logger.debug("解密 API Secret 失败: ${e.message}")
                return null
            }
            val apiPassphrase = try {
                cryptoUtils.decrypt(account.apiPassphrase)
            } catch (e: Exception) {
                logger.debug("解密 API Passphrase 失败: ${e.message}")
                return null
            }
            // 创建带鉴权的 CLOB API 客户端
            retrofitFactory.createClobApi(apiKey, apiSecret, apiPassphrase, account.walletAddress)
        } catch (e: Exception) {
            logger.debug("获取带鉴权的 CLOB API 失败: ${e.message}")
            null
        }
    }
 }
@@ -0,0 +1,234 @@
 package com.wrbug.polymarketbot.service.common
 import com.github.benmanes.caffeine.cache.Cache
 import com.github.benmanes.caffeine.cache.Caffeine
 import com.wrbug.polymarketbot.api.MarketResponse
 import com.wrbug.polymarketbot.api.PolymarketGammaApi
 import com.wrbug.polymarketbot.entity.Market
 import com.wrbug.polymarketbot.repository.MarketRepository
 import com.wrbug.polymarketbot.util.RetrofitFactory
 import com.wrbug.polymarketbot.util.getEventSlug
 import kotlinx.coroutines.runBlocking
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
 import java.time.Instant
 import java.time.format.DateTimeFormatter
 /**
 * 市场信息服务
 * 负责缓存和管理市场信息
 */
@Service
 class MarketService(
    val marketRepository: MarketRepository,  // 改为 public，供 MarketPollingService 使用
    private val retrofitFactory: RetrofitFactory
 ) {
    private val logger = LoggerFactory.getLogger(MarketService::class.java)
    // LRU 缓存（避免频繁查询数据库），最多缓存 200 条记录
    private val marketCache: Cache<String, Market> = Caffeine.newBuilder()
        .maximumSize(200)  // 最多缓存 200 条记录
        .build()
    /**
     * 根据市场ID获取市场信息
     * 优先从缓存获取，如果不存在则从数据库查询，如果数据库也没有则从API获取并保存
     */
    fun getMarket(marketId: String): Market? {
        // 1. 从缓存获取
        marketCache.getIfPresent(marketId)?.let { return it }
        // 2. 从数据库查询
        val market = marketRepository.findByMarketId(marketId)
        if (market != null) {
            marketCache.put(marketId, market)
            return market
        }
        // 3. 从API获取（异步，不阻塞）
        runBlocking {
            try {
                fetchAndSaveMarket(marketId)
            } catch (e: Exception) {
                logger.warn("获取市场信息失败: marketId=$marketId, error=${e.message}")
            }
        }
        // 再次从数据库查询（API可能已经保存）
        return marketRepository.findByMarketId(marketId)?.also {
            marketCache.put(marketId, it)
        }
    }
    /**
     * 批量获取市场信息
     */
    fun getMarkets(marketIds: List<String>): Map<String, Market> {
        val result = mutableMapOf<String, Market>()
        val missingIds = mutableListOf<String>()
        // 1. 从缓存和数据库获取
        for (marketId in marketIds) {
            val market = getMarket(marketId)
            if (market != null) {
                result[marketId] = market
            } else {
                missingIds.add(marketId)
            }
        }
        // 2. 批量从API获取缺失的市场信息
        if (missingIds.isNotEmpty()) {
            runBlocking {
                try {
                    fetchAndSaveMarkets(missingIds)
                } catch (e: Exception) {
                    logger.warn("批量获取市场信息失败: marketIds=$missingIds, error=${e.message}")
                }
            }
            // 再次从数据库查询
            val savedMarkets = marketRepository.findByMarketIdIn(missingIds)
            for (market in savedMarkets) {
                result[market.marketId] = market
                marketCache.put(market.marketId, market)
            }
        }
        return result
    }
    /**
     * 从API获取市场信息并保存到数据库
     */
    private suspend fun fetchAndSaveMarket(marketId: String): Market? {
        return try {
            val gammaApi = retrofitFactory.createGammaApi()
            val response = gammaApi.listMarkets(conditionIds = listOf(marketId))
            if (response.isSuccessful && response.body() != null) {
                val markets = response.body()!!
                if (markets.isNotEmpty()) {
                    val marketResponse = markets.first()
                    saveMarketFromResponse(marketId, marketResponse)
                } else {
                    null
                }
            } else {
                null
            }
        } catch (e: Exception) {
            logger.error("从API获取市场信息失败: marketId=$marketId, error=${e.message}", e)
            null
        }
    }
    /**
     * 批量从API获取市场信息并保存到数据库
     */
    private suspend fun fetchAndSaveMarkets(marketIds: List<String>) {
        if (marketIds.isEmpty()) return
        try {
            val gammaApi = retrofitFactory.createGammaApi()
            val response = gammaApi.listMarkets(conditionIds = marketIds)
            if (response.isSuccessful && response.body() != null) {
                val markets = response.body()!!
                val marketMap = markets.associateBy { it.conditionId ?: "" }
                for (marketId in marketIds) {
                    val marketResponse = marketMap[marketId]
                    if (marketResponse != null) {
                        saveMarketFromResponse(marketId, marketResponse)
                    }
                }
            }
        } catch (e: Exception) {
            logger.error("批量从API获取市场信息失败: marketIds=$marketIds, error=${e.message}", e)
        }
    }
    /**
     * 从API响应保存市场信息到数据库
     */
    private fun saveMarketFromResponse(marketId: String, marketResponse: MarketResponse): Market? {
        return try {
            val existingMarket = marketRepository.findByMarketId(marketId)
            // 保存原来的 slug（用于显示）
            val slug = marketResponse.slug
            // 保存跳转用的 slug（从 events[0].slug 获取）
            val eventSlug = marketResponse.getEventSlug()
            val market = if (existingMarket != null) {
                // 更新现有市场信息
                existingMarket.copy(
                    title = marketResponse.question ?: existingMarket.title,
                    slug = slug ?: existingMarket.slug,
                    eventSlug = eventSlug ?: existingMarket.eventSlug,
                    category = marketResponse.category ?: existingMarket.category,
                    icon = marketResponse.icon ?: existingMarket.icon,
                    image = marketResponse.image ?: existingMarket.image,
                    description = marketResponse.description ?: existingMarket.description,
                    active = marketResponse.active ?: existingMarket.active,
                    closed = marketResponse.closed ?: existingMarket.closed,
                    archived = marketResponse.archived ?: existingMarket.archived,
                    endDate = parseEndDate(marketResponse.endDate),
                    updatedAt = System.currentTimeMillis()
                )
            } else {
                // 创建新市场信息
                Market(
                    marketId = marketId,
                    title = marketResponse.question ?: marketId,
                    slug = slug,
                    eventSlug = eventSlug,
                    category = marketResponse.category,
                    icon = marketResponse.icon,
                    image = marketResponse.image,
                    description = marketResponse.description,
                    active = marketResponse.active ?: true,
                    closed = marketResponse.closed ?: false,
                    archived = marketResponse.archived ?: false,
                    endDate = parseEndDate(marketResponse.endDate),
                    createdAt = System.currentTimeMillis(),
                    updatedAt = System.currentTimeMillis()
                )
            }
            val savedMarket = marketRepository.save(market)
            marketCache.put(marketId, savedMarket)
            savedMarket
        } catch (e: Exception) {
            logger.error("保存市场信息失败: marketId=$marketId, error=${e.message}", e)
            null
        }
    }
    /**
     * 清除缓存（用于测试或手动刷新）
     */
    fun clearCache() {
        marketCache.invalidateAll()
    }
    /**
     * 解析市场截止时间（ISO 8601 格式）
     */
    private fun parseEndDate(endDate: String?): Long? {
        if (endDate.isNullOrBlank()) {
            return null
        }
        return try {
            // ISO 8601 格式，例如：2025-03-15T12:00:00Z
            Instant.parse(endDate).toEpochMilli()
        } catch (e: Exception) {
            logger.warn("解析市场截止时间失败: endDate=$endDate, error=${e.message}")
            null
        }
    }
 }
@@ -1,13 +1,14 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.common
 import com.google.gson.Gson
 import com.wrbug.polymarketbot.api.ApiKeyResponse
 import com.wrbug.polymarketbot.api.PolymarketClobApi
 import com.wrbug.polymarketbot.constants.PolymarketConstants
 import com.wrbug.polymarketbot.util.PolymarketL1AuthInterceptor
 import com.wrbug.polymarketbot.util.RetrofitFactory
 import com.wrbug.polymarketbot.util.createClient
 import kotlinx.coroutines.runBlocking
 import org.slf4j.LoggerFactory
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.stereotype.Service
 import retrofit2.Retrofit
 import retrofit2.converter.gson.GsonConverterFactory
@@ -18,8 +19,7 @@ import retrofit2.converter.gson.GsonConverterFactory
 */
@Service
 class PolymarketApiKeyService(
-    @Value("\${polymarket.clob.base-url}")
+    private val gson: Gson
    private val clobBaseUrl: String
 ) {
    private val logger = LoggerFactory.getLogger(PolymarketApiKeyService::class.java)
@@ -52,34 +52,36 @@ class PolymarketApiKeyService(
            try {
                // 先尝试获取现有的 API Key（derive）
                val deriveResult = deriveApiKey(privateKey, walletAddress, chainId)
                val maskedAddress = "${walletAddress.take(6)}...${walletAddress.takeLast(4)}"
                if (deriveResult.isSuccess) {
                    val creds = deriveResult.getOrNull()
                    if (creds != null && isApiCreds(creds)) {
-                        logger.info("成功获取现有 API Key: ${walletAddress}")
+                        logger.debug("成功获取现有 API Key: $maskedAddress")
                        return@runBlocking Result.success(creds)
                    }
                }
-                
+
                // 如果获取失败或返回无效，尝试创建新的
-                logger.info("获取现有 API Key 失败，尝试创建新的: ${walletAddress}")
+                logger.debug("获取现有 API Key 失败，尝试创建新的: $maskedAddress")
                val createResult = createApiKey(privateKey, walletAddress, chainId)
                if (createResult.isSuccess) {
                    val creds = createResult.getOrNull()
                    if (creds != null && isApiCreds(creds)) {
-                        logger.info("成功创建新 API Key: ${walletAddress}")
+                        logger.debug("成功创建新 API Key: $maskedAddress")
                        return@runBlocking Result.success(creds)
                    }
                }
-                
+
                // 两个都失败
                val error = createResult.exceptionOrNull() ?: deriveResult.exceptionOrNull()
                val errorMsg = error?.message ?: "未知错误"
-                logger.error("获取和创建 API Key 都失败: ${walletAddress}", error)
+                logger.error("获取和创建 API Key 都失败: $maskedAddress", error)
                Result.failure(
                    IllegalStateException("无法获取或创建 API Key: $errorMsg")
                )
            } catch (e: Exception) {
-                logger.error("创建或获取 API Key 异常: ${walletAddress}", e)
+                val maskedAddress = "${walletAddress.take(6)}...${walletAddress.takeLast(4)}"
                logger.error("创建或获取 API Key 异常: $maskedAddress", e)
                Result.failure(e)
            }
        }
@@ -220,9 +222,9 @@ class PolymarketApiKeyService(
            .build()
        return Retrofit.Builder()
-            .baseUrl(clobBaseUrl)
+            .baseUrl(PolymarketConstants.CLOB_BASE_URL)
            .client(okHttpClient)
-            .addConverterFactory(GsonConverterFactory.create())
+            .addConverterFactory(GsonConverterFactory.create(gson))
            .build()
            .create(PolymarketClobApi::class.java)
    }
@@ -234,9 +236,9 @@ class PolymarketApiKeyService(
        val okHttpClient = createClient().build()
        return Retrofit.Builder()
-            .baseUrl(clobBaseUrl)
+            .baseUrl(PolymarketConstants.CLOB_BASE_URL)
            .client(okHttpClient)
-            .addConverterFactory(GsonConverterFactory.create())
+            .addConverterFactory(GsonConverterFactory.create(gson))
            .build()
            .create(PolymarketClobApi::class.java)
    }
@@ -1,4 +1,4 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.common
 import com.wrbug.polymarketbot.api.*
 import com.wrbug.polymarketbot.util.RetrofitFactory
@@ -300,13 +300,23 @@ class PolymarketClobService(
            )
            val response = authenticatedClobApi.getOrder(orderId)
-            if (response.isSuccessful && response.body() != null) {
+            if (response.isSuccessful) {
-                Result.success(response.body()!!)
+                val body = response.body()
                if (body != null) {
                    Result.success(body)
                } else {
                    // 响应体为空，可能是订单不存在或已过期
                    logger.warn("获取订单详情失败: 响应体为空, orderId=$orderId, code=${response.code()}")
                    Result.failure(Exception("订单不存在或已过期: orderId=$orderId"))
                }
            } else {
-                Result.failure(Exception("获取订单详情失败: ${response.code()} ${response.message()}"))
+                // HTTP 状态码不是 2xx
                val errorBody = response.errorBody()?.string()?.take(200) ?: "无错误详情"
                logger.warn("获取订单详情失败: HTTP ${response.code()}, orderId=$orderId, errorBody=$errorBody")
                Result.failure(Exception("获取订单详情失败: HTTP ${response.code()} ${response.message()}"))
            }
        } catch (e: Exception) {
-            logger.error("获取订单详情异常: ${e.message}", e)
+            logger.error("获取订单详情异常: orderId=$orderId, ${e.message}", e)
            Result.failure(e)
        }
    }
@@ -391,5 +401,37 @@ class PolymarketClobService(
            Result.failure(e)
        }
    }
    /**
     * 获取费率
     * 文档: https://docs.polymarket.com/developers/market-makers/maker-rebates-program#1-fetch-the-fee-rate
     * 
     * 注意：根据 TypeScript clob-client 源码，API 返回的字段名是 base_fee，而不是文档中的 fee_rate_bps
     * 参考: clob-client/src/client.ts:312
     * 
     * @param tokenId Token ID
     * @return 费率基点（0 表示无费率，1000 表示 10%）
     */
    suspend fun getFeeRate(tokenId: String): Result<Int> {
        return try {
            val response = clobApi.getFeeRate(tokenId)
            if (response.isSuccessful && response.body() != null) {
                val baseFee = response.body()!!.baseFee
                logger.debug("获取费率成功: tokenId=$tokenId, baseFee=$baseFee")
                Result.success(baseFee)
            } else {
                val errorBody = try {
                    response.errorBody()?.string()
                } catch (e: Exception) {
                    null
                }
                logger.error("获取费率失败: tokenId=$tokenId, code=${response.code()}, errorBody=$errorBody")
                Result.failure(Exception("获取费率失败: ${response.code()} ${response.message()}"))
            }
        } catch (e: Exception) {
            logger.error("获取费率异常: tokenId=$tokenId, error=${e.message}", e)
            Result.failure(e)
        }
    }
 }
@@ -0,0 +1,135 @@
 package com.wrbug.polymarketbot.service.common
 import org.slf4j.LoggerFactory
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.stereotype.Service
 import java.util.concurrent.ConcurrentHashMap
 import java.util.concurrent.atomic.AtomicReference
 /**
 * 频率限制服务（使用内存缓存）
 */
@Service
 class RateLimitService {
    private val logger = LoggerFactory.getLogger(RateLimitService::class.java)
    // 重置密码限速配置
    @Value("\${rate-limit.reset-password.max-attempts:3}")
    private var resetPasswordMaxAttempts: Int = 3
    @Value("\${rate-limit.reset-password.window-seconds:60}")
    private var resetPasswordWindowSeconds: Long = 60
    // 登录限速配置
    @Value("\${rate-limit.login.max-attempts:5}")
    private var loginMaxAttempts: Int = 5
    @Value("\${rate-limit.login.window-seconds:300}")
    private var loginWindowSeconds: Long = 300  // 5分钟
    @Value("\${rate-limit.login.lockout-seconds:900}")
    private var loginLockoutSeconds: Long = 900  // 15分钟
    // 全局尝试记录列表（时间戳），所有请求共享
    private val resetPasswordAttempts = AtomicReference<MutableList<Long>>(mutableListOf())
    // 登录失败尝试记录（IP -> 时间戳列表）
    private val loginFailedAttempts = ConcurrentHashMap<String, MutableList<Long>>()
    // 登录锁定记录（IP -> 锁定结束时间）
    private val loginLockouts = ConcurrentHashMap<String, Long>()
    /**
     * 检查重置密码频率限制（全局限制，不按IP）
     * @return Result，如果超过限制则返回失败
     */
    fun checkResetPasswordRateLimit(): Result<Unit> {
        val now = System.currentTimeMillis()
        val windowStart = now - (resetPasswordWindowSeconds * 1000)
        // 获取当前尝试记录列表
        val attempts = resetPasswordAttempts.get()
        // 清理过期记录（超过时间窗口的记录）
        val validAttempts = attempts.filter { it >= windowStart }.toMutableList()
        // 检查是否超过限制
        if (validAttempts.size >= resetPasswordMaxAttempts) {
            logger.warn("重置密码频率限制触发: attempts=${validAttempts.size}/$resetPasswordMaxAttempts")
            return Result.failure(IllegalStateException("频率限制：1分钟内最多尝试${resetPasswordMaxAttempts}次，请稍后再试"))
        }
        // 记录本次尝试
        validAttempts.add(now)
        resetPasswordAttempts.set(validAttempts)
        return Result.success(Unit)
    }
    /**
     * 检查登录频率限制（按IP限制）
     * @param ipAddress 客户端IP地址
     * @return Result，如果被锁定或超过限制则返回失败
     */
    fun checkLoginRateLimit(ipAddress: String): Result<Unit> {
        val now = System.currentTimeMillis()
        // 检查是否被锁定
        val lockoutEndTime = loginLockouts[ipAddress]
        if (lockoutEndTime != null) {
            if (now < lockoutEndTime) {
                val remainingSeconds = (lockoutEndTime - now) / 1000
                logger.warn("登录锁定中: ip=$ipAddress, remainingSeconds=$remainingSeconds")
                return Result.failure(IllegalStateException("账户已被锁定，请${remainingSeconds}秒后再试"))
            } else {
                // 锁定已过期，清除锁定记录
                loginLockouts.remove(ipAddress)
                loginFailedAttempts.remove(ipAddress)
            }
        }
        return Result.success(Unit)
    }
    /**
     * 记录登录失败尝试
     * @param ipAddress 客户端IP地址
     * @return 如果触发锁定返回锁定信息，否则返回 null
     */
    fun recordLoginFailure(ipAddress: String): String? {
        val now = System.currentTimeMillis()
        val windowStart = now - (loginWindowSeconds * 1000)
        // 获取或创建该IP的尝试记录
        val attempts = loginFailedAttempts.computeIfAbsent(ipAddress) { mutableListOf() }
        // 清理过期记录并添加新记录
        synchronized(attempts) {
            attempts.removeIf { it < windowStart }
            attempts.add(now)
            // 检查是否需要锁定
            if (attempts.size >= loginMaxAttempts) {
                val lockoutEndTime = now + (loginLockoutSeconds * 1000)
                loginLockouts[ipAddress] = lockoutEndTime
                logger.warn("登录锁定触发: ip=$ipAddress, attempts=${attempts.size}, lockoutSeconds=$loginLockoutSeconds")
                return "登录失败次数过多，账户已被锁定${loginLockoutSeconds / 60}分钟"
            }
        }
        val remainingAttempts = loginMaxAttempts - attempts.size
        logger.warn("登录失败: ip=$ipAddress, attempts=${attempts.size}/$loginMaxAttempts, remainingAttempts=$remainingAttempts")
        return null
    }
    /**
     * 登录成功时清除失败记录
     * @param ipAddress 客户端IP地址
     */
    fun clearLoginFailures(ipAddress: String) {
        loginFailedAttempts.remove(ipAddress)
        loginLockouts.remove(ipAddress)
    }
 }
@@ -1,9 +1,11 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.common
 import com.wrbug.polymarketbot.dto.OrderPushMessage
 import com.wrbug.polymarketbot.dto.PositionPushMessage
 import com.wrbug.polymarketbot.dto.WebSocketMessage as WsMessage
 import com.wrbug.polymarketbot.dto.WebSocketMessageType
 import com.wrbug.polymarketbot.service.accounts.PositionPushService
 import com.wrbug.polymarketbot.service.copytrading.orders.OrderPushService
 import kotlinx.coroutines.*
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
@@ -0,0 +1,431 @@
 package com.wrbug.polymarketbot.service.copytrading.configs
 import com.wrbug.polymarketbot.api.OrderbookResponse
 import com.wrbug.polymarketbot.entity.CopyTrading
 import com.wrbug.polymarketbot.util.gt
 import com.wrbug.polymarketbot.util.lt
 import com.wrbug.polymarketbot.util.multi
 import com.wrbug.polymarketbot.util.toSafeBigDecimal
 import com.wrbug.polymarketbot.util.JsonUtils
 import org.slf4j.LoggerFactory
 import com.wrbug.polymarketbot.service.common.PolymarketClobService
 import com.wrbug.polymarketbot.service.accounts.AccountService
 import com.wrbug.polymarketbot.repository.CopyOrderTrackingRepository
 import org.springframework.stereotype.Service
 import java.math.BigDecimal
 /**
 * 跟单过滤条件检查服务
 */
@Service
 class CopyTradingFilterService(
    private val clobService: PolymarketClobService,
    private val accountService: AccountService,
    private val copyOrderTrackingRepository: CopyOrderTrackingRepository,
    private val jsonUtils: JsonUtils
 ) {
    private val logger = LoggerFactory.getLogger(CopyTradingFilterService::class.java)
    /**
     * 检查过滤条件
     * @param copyTrading 跟单配置
     * @param tokenId token ID（用于获取订单簿）
     * @param tradePrice Leader 交易价格，用于价格区间检查
     * @param copyOrderAmount 跟单金额（USDC），用于仓位检查，如果为null则不进行仓位检查
     * @param marketId 市场ID，用于仓位检查（按市场过滤仓位）
     * @param marketTitle 市场标题，用于关键字过滤
     * @param marketEndDate 市场截止时间，用于市场截止时间检查
     * @return 过滤结果
     */
    suspend fun checkFilters(
        copyTrading: CopyTrading,
        tokenId: String,
        tradePrice: BigDecimal? = null,  // Leader 交易价格，用于价格区间检查
        copyOrderAmount: BigDecimal? = null,  // 跟单金额（USDC），用于仓位检查
        marketId: String? = null,  // 市场ID，用于仓位检查（按市场过滤仓位）
        marketTitle: String? = null,  // 市场标题，用于关键字过滤
        marketEndDate: Long? = null,  // 市场截止时间，用于市场截止时间检查
        outcomeIndex: Int? = null  // 方向索引（0, 1, 2, ...），用于按市场+方向检查仓位
    ): FilterResult {
        // 1. 关键字过滤检查（如果配置了关键字过滤）
        if (copyTrading.keywordFilterMode != null && copyTrading.keywordFilterMode != "DISABLED") {
            val keywordCheck = checkKeywordFilter(copyTrading, marketTitle)
            if (!keywordCheck.isPassed) {
                return keywordCheck
            }
        }
        // 1.5. 市场截止时间检查（如果配置了市场截止时间限制）
        if (copyTrading.maxMarketEndDate != null) {
            val marketEndDateCheck = checkMarketEndDate(copyTrading, marketEndDate)
            if (!marketEndDateCheck.isPassed) {
                return marketEndDateCheck
            }
        }
        // 2. 价格区间检查（如果配置了价格区间）
        if (tradePrice != null) {
            val priceRangeCheck = checkPriceRange(copyTrading, tradePrice)
            if (!priceRangeCheck.isPassed) {
                return FilterResult.priceRangeFailed(priceRangeCheck.reason)
            }
        }
        // 3. 检查是否需要获取订单簿或需要执行仓位检查
        // 只有在配置了需要订单簿的过滤条件时才获取订单簿
        val needOrderbook = copyTrading.maxSpread != null || copyTrading.minOrderDepth != null
        // 3.5. 如果不需要订单簿，则跳过订单簿相关的检查，但仍然需要检查仓位限制
        if (!needOrderbook) {
            // 仓位检查（如果配置了最大仓位限制且提供了跟单金额和市场ID）
            if (copyOrderAmount != null && marketId != null) {
                val positionCheck = checkPositionLimits(copyTrading, copyOrderAmount, marketId, outcomeIndex)
                if (!positionCheck.isPassed) {
                    return positionCheck
                }
            }
            // 通过所有检查
            return FilterResult.passed()
        }
        // 4. 获取订单簿（仅在需要时，只请求一次）
        val orderbookResult = clobService.getOrderbookByTokenId(tokenId)
        if (!orderbookResult.isSuccess) {
            val error = orderbookResult.exceptionOrNull()
            return FilterResult.orderbookError("获取订单簿失败: ${error?.message ?: "未知错误"}")
        }
        val orderbook = orderbookResult.getOrNull()
            ?: return FilterResult.orderbookEmpty()
        // 5. 买一卖一价差过滤（如果配置了）
        if (copyTrading.maxSpread != null) {
            val spreadCheck = checkSpread(copyTrading, orderbook)
            if (!spreadCheck.isPassed) {
                return FilterResult.spreadFailed(spreadCheck.reason, orderbook)
            }
        }
        // 6. 订单深度过滤（如果配置了，检查所有方向）
        if (copyTrading.minOrderDepth != null) {
            val depthCheck = checkOrderDepth(copyTrading, orderbook)
            if (!depthCheck.isPassed) {
                return FilterResult.orderDepthFailed(depthCheck.reason, orderbook)
            }
        }
        // 7. 仓位检查（如果配置了最大仓位限制且提供了跟单金额和市场ID）
        if (copyOrderAmount != null && marketId != null) {
            val positionCheck = checkPositionLimits(copyTrading, copyOrderAmount, marketId, outcomeIndex)
            if (!positionCheck.isPassed) {
                return positionCheck
            }
        }
        return FilterResult.passed(orderbook)
    }
    /**
     * 检查关键字过滤
     * @param copyTrading 跟单配置
     * @param marketTitle 市场标题
     * @return 过滤结果
     */
    private fun checkKeywordFilter(
        copyTrading: CopyTrading,
        marketTitle: String?
    ): FilterResult {
        // 如果未启用关键字过滤，直接通过
        if (copyTrading.keywordFilterMode == null || copyTrading.keywordFilterMode == "DISABLED") {
            return FilterResult.passed()
        }
        // 如果没有市场标题，无法进行关键字过滤，为了安全起见，不通过
        if (marketTitle.isNullOrBlank()) {
            return FilterResult.keywordFilterFailed("市场标题为空，无法进行关键字过滤")
        }
        // 解析关键字列表
        val keywords = jsonUtils.parseStringArray(copyTrading.keywords)
        if (keywords.isEmpty()) {
            // 如果关键字列表为空，白名单模式不通过，黑名单模式通过
            return if (copyTrading.keywordFilterMode == "WHITELIST") {
                FilterResult.keywordFilterFailed("白名单模式但关键字列表为空")
            } else {
                FilterResult.passed()
            }
        }
        // 将市场标题转换为小写，用于不区分大小写的匹配
        val titleLower = marketTitle.lowercase()
        // 检查市场标题是否包含任意关键字
        val containsKeyword = keywords.any { keyword ->
            titleLower.contains(keyword.lowercase())
        }
        // 根据过滤模式决定是否通过
        return when (copyTrading.keywordFilterMode) {
            "WHITELIST" -> {
                if (containsKeyword) {
                    FilterResult.passed()
                } else {
                    FilterResult.keywordFilterFailed("白名单模式：市场标题不包含任何关键字。市场标题：$marketTitle，关键字列表：${keywords.joinToString(", ")}")
                }
            }
            "BLACKLIST" -> {
                if (containsKeyword) {
                    FilterResult.keywordFilterFailed("黑名单模式：市场标题包含关键字。市场标题：$marketTitle，匹配的关键字：${keywords.filter { titleLower.contains(it.lowercase()) }.joinToString(", ")}")
                } else {
                    FilterResult.passed()
                }
            }
            else -> FilterResult.passed()
        }
    }
    /**
     * 检查价格区间
     * @param copyTrading 跟单配置
     * @param tradePrice Leader 交易价格
     * @return 过滤结果
     */
    private fun checkPriceRange(
        copyTrading: CopyTrading,
        tradePrice: BigDecimal
    ): FilterResult {
        // 如果未配置价格区间，直接通过
        if (copyTrading.minPrice == null && copyTrading.maxPrice == null) {
            return FilterResult.passed()
        }
        // 检查最低价格
        if (copyTrading.minPrice != null && tradePrice.lt(copyTrading.minPrice)) {
            return FilterResult.priceRangeFailed("价格低于最低限制: $tradePrice < ${copyTrading.minPrice}")
        }
        // 检查最高价格
        if (copyTrading.maxPrice != null && tradePrice.gt(copyTrading.maxPrice)) {
            return FilterResult.priceRangeFailed("价格高于最高限制: $tradePrice > ${copyTrading.maxPrice}")
        }
        return FilterResult.passed()
    }
    /**
     * 检查买一卖一价差
     * bestBid: 买盘中的最高价格（最大值）
     * bestAsk: 卖盘中的最低价格（最小值）
     */
    private fun checkSpread(
        copyTrading: CopyTrading,
        orderbook: OrderbookResponse
    ): FilterResult {
        // 如果未启用价差过滤，直接通过
        if (copyTrading.maxSpread == null) {
            return FilterResult.passed()
        }
        // 获取买盘中的最高价格（bestBid = bids 中的最大值）
        val bestBid = orderbook.bids
            .mapNotNull { it.price.toSafeBigDecimal() }
            .maxOrNull()
        // 获取卖盘中的最低价格（bestAsk = asks 中的最小值）
        val bestAsk = orderbook.asks
            .mapNotNull { it.price.toSafeBigDecimal() }
            .minOrNull()
        if (bestBid == null || bestAsk == null) {
            return FilterResult.spreadFailed("订单簿缺少买一或卖一价格", orderbook)
        }
        // 计算价差（绝对价格）
        val spread = bestAsk.subtract(bestBid)
        if (spread.gt(copyTrading.maxSpread)) {
            return FilterResult.spreadFailed("价差过大: $spread > ${copyTrading.maxSpread}", orderbook)
        }
        return FilterResult.passed()
    }
    /**
     * 检查订单深度（检查所有方向：买盘和卖盘的总深度）
     */
    private fun checkOrderDepth(
        copyTrading: CopyTrading,
        orderbook: OrderbookResponse
    ): FilterResult {
        // 如果未启用订单深度过滤，直接通过
        if (copyTrading.minOrderDepth == null) {
            return FilterResult.passed()
        }
        // 计算买盘（bids）总深度
        var bidsDepth = BigDecimal.ZERO
        for (order in orderbook.bids) {
            val price = order.price.toSafeBigDecimal()
            val size = order.size.toSafeBigDecimal()
            val orderAmount = price.multi(size)
            bidsDepth = bidsDepth.add(orderAmount)
        }
        // 计算卖盘（asks）总深度
        var asksDepth = BigDecimal.ZERO
        for (order in orderbook.asks) {
            val price = order.price.toSafeBigDecimal()
            val size = order.size.toSafeBigDecimal()
            val orderAmount = price.multi(size)
            asksDepth = asksDepth.add(orderAmount)
        }
        // 计算总深度（买盘 + 卖盘）
        val totalDepth = bidsDepth.add(asksDepth)
        if (totalDepth.lt(copyTrading.minOrderDepth)) {
            return FilterResult.orderDepthFailed("订单深度不足: $totalDepth < ${copyTrading.minOrderDepth}", orderbook)
        }
        return FilterResult.passed()
    }
    /**
     * 检查仓位限制（按市场+方向检查）
     * @param copyTrading 跟单配置
     * @param copyOrderAmount 跟单金额（USDC）
     * @param marketId 市场ID，用于过滤该市场的仓位
     * @param outcomeIndex 方向索引（0, 1, 2, ...），用于按市场+方向检查仓位
     * @return 过滤结果
     */
    private suspend fun checkPositionLimits(
        copyTrading: CopyTrading,
        copyOrderAmount: BigDecimal,
        marketId: String,
        outcomeIndex: Int?
    ): FilterResult {
        // 如果未配置仓位限制，直接通过
        if (copyTrading.maxPositionValue == null && copyTrading.maxPositionCount == null) {
            return FilterResult.passed()
        }
        try {
            // 获取账户的所有仓位信息
            val positionsResult = accountService.getAllPositions()
            if (positionsResult.isFailure) {
                logger.warn("获取仓位信息失败，跳过仓位检查: accountId=${copyTrading.accountId}, marketId=$marketId, outcomeIndex=$outcomeIndex, error=${positionsResult.exceptionOrNull()?.message}")
                // 如果获取仓位失败，为了安全起见，不通过检查
                return FilterResult.maxPositionValueFailed("获取仓位信息失败，无法进行仓位检查")
            }
            val positions = positionsResult.getOrNull() ?: return FilterResult.maxPositionValueFailed("仓位信息为空")
            // 过滤出当前账户且该市场的仓位
            val marketPositions = positions.currentPositions.filter {
                it.accountId == copyTrading.accountId && it.marketId == marketId
            }
            // 检查最大仓位金额（如果配置了）
            if (copyTrading.maxPositionValue != null && outcomeIndex != null) {
                // 按市场+方向（outcomeIndex）分别计算数据库成本价
                val dbValue = copyOrderTrackingRepository.sumCurrentPositionValueByMarketAndOutcomeIndex(
                    copyTrading.id!!, marketId, outcomeIndex
                ) ?: BigDecimal.ZERO
                // 外部持仓也需要按方向过滤，但由于外部持仓可能没有 outcomeIndex 信息，这里保守处理：
                // 如果外部持仓存在，取该市场的所有外部持仓市值（与数据库取最大值）
                val extValue = if (marketPositions.isNotEmpty()) {
                    marketPositions.sumOf { it.currentValue.toSafeBigDecimal() }
                } else {
                    BigDecimal.ZERO
                }
                // 取数据库值和外部持仓值的最大值
                val currentPositionValue = dbValue.max(extValue)
                // 检查：该市场该方向的当前仓位 + 跟单金额 <= 最大仓位金额
                val totalValueAfterOrder = currentPositionValue.add(copyOrderAmount)
                if (totalValueAfterOrder.gt(copyTrading.maxPositionValue)) {
                    return FilterResult.maxPositionValueFailed(
                        "超过最大仓位金额限制: 市场=$marketId, 方向=$outcomeIndex, 当前仓位(取最大值)=${currentPositionValue} USDC (DB=${dbValue}, Ext=${extValue}), 跟单金额=${copyOrderAmount} USDC, 总计=${totalValueAfterOrder} USDC > 最大限制=${copyTrading.maxPositionValue} USDC"
                    )
                }
            }
            // 检查最大仓位数量（如果配置了）
            if (copyTrading.maxPositionCount != null) {
                // 使用数据库中的订单记录计算活跃仓位数量（解决延迟问题）
                val dbCount = copyOrderTrackingRepository.countActivePositions(copyTrading.id!!)
                // 计算外部持仓中的唯一市场数量（防止遗漏非本项目创建的仓位）
                val extCount = positions.currentPositions
                    .filter { it.accountId == copyTrading.accountId }
                    .map { it.marketId }
                    .distinct()
                    .size
                val currentPositionCount = maxOf(dbCount, extCount)
                // 检查：如果当前没有该市场该方向的活跃仓位，且总仓位数量已达到限制，则不允许开新仓
                // 判断当前市场该方向是否已有活跃仓位（数据库）
                val hasDbPosition = if (outcomeIndex != null) {
                    copyOrderTrackingRepository.findUnmatchedBuyOrdersByOutcomeIndex(
                        copyTrading.id, marketId, outcomeIndex
                    ).isNotEmpty()
                } else {
                    false
                }
                val hasExtPosition = marketPositions.isNotEmpty()
                val hasCurrentMarketPosition = hasDbPosition || hasExtPosition
                if (!hasCurrentMarketPosition && currentPositionCount >= copyTrading.maxPositionCount) {
                    return FilterResult.maxPositionCountFailed(
                        "超过最大仓位数量限制: 当前活跃仓位总数(取最大值)=${currentPositionCount} (DB=${dbCount}, Ext=${extCount}) >= 最大限制=${copyTrading.maxPositionCount}"
                    )
                }
            }
            return FilterResult.passed()
        } catch (e: Exception) {
            logger.error("仓位检查异常: accountId=${copyTrading.accountId}, marketId=$marketId, outcomeIndex=$outcomeIndex, error=${e.message}", e)
            // 如果检查异常，为了安全起见，不通过检查
            return FilterResult.maxPositionValueFailed("仓位检查异常: ${e.message}")
        }
    }
    /**
     * 检查市场截止时间
     * @param copyTrading 跟单配置
     * @param marketEndDate 市场截止时间（毫秒时间戳）
     * @return 过滤结果
     */
    private fun checkMarketEndDate(
        copyTrading: CopyTrading,
        marketEndDate: Long?
    ): FilterResult {
        // 如果未配置市场截止时间限制，直接通过
        if (copyTrading.maxMarketEndDate == null) {
            return FilterResult.passed()
        }
        // 如果没有市场截止时间，无法检查，为了安全起见，不通过
        if (marketEndDate == null) {
            return FilterResult.marketEndDateFailed("市场缺少截止时间信息，无法进行市场截止时间检查")
        }
        // 检查：市场截止时间 - 当前时间 <= 最大限制时间
        val currentTime = System.currentTimeMillis()
        val remainingTime = marketEndDate - currentTime
        if (remainingTime > copyTrading.maxMarketEndDate) {
            return FilterResult.marketEndDateFailed(
                "市场截止时间超出限制: 剩余时间=${remainingTime}ms (${remainingTime / (1000 * 60 * 60)}小时) > 最大限制=${copyTrading.maxMarketEndDate}ms (${copyTrading.maxMarketEndDate / (1000 * 60 * 60)}小时)"
            )
        }
        return FilterResult.passed()
    }
 }
@@ -1,13 +1,21 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.copytrading.configs
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.entity.Account
 import com.wrbug.polymarketbot.entity.CopyTrading
 import com.wrbug.polymarketbot.entity.Leader
 import com.wrbug.polymarketbot.repository.AccountRepository
 import com.wrbug.polymarketbot.repository.CopyTradingRepository
 import com.wrbug.polymarketbot.repository.CopyTradingTemplateRepository
 import com.wrbug.polymarketbot.repository.LeaderRepository
 import com.wrbug.polymarketbot.service.copytrading.monitor.CopyTradingMonitorService
 import com.google.gson.Gson
 import com.wrbug.polymarketbot.util.IllegalBigDecimal
 import com.wrbug.polymarketbot.util.JsonUtils
 import com.wrbug.polymarketbot.util.toSafeBigDecimal
 import org.slf4j.LoggerFactory
 import org.springframework.context.ApplicationContext
 import org.springframework.context.ApplicationContextAware
 import org.springframework.stereotype.Service
 import org.springframework.transaction.annotation.Transactional
 import java.math.BigDecimal
@@ -21,11 +29,27 @@ class CopyTradingService(
    private val accountRepository: AccountRepository,
    private val templateRepository: CopyTradingTemplateRepository,
    private val leaderRepository: LeaderRepository,
-    private val monitorService: CopyTradingMonitorService
+    private val monitorService: CopyTradingMonitorService,
-) {
+    private val jsonUtils: JsonUtils,
-    
+    private val gson: Gson
 ) : ApplicationContextAware {
    private val logger = LoggerFactory.getLogger(CopyTradingService::class.java)
    private var applicationContext: ApplicationContext? = null
    override fun setApplicationContext(applicationContext: ApplicationContext) {
        this.applicationContext = applicationContext
    }
    /**
     * 获取代理对象，用于解决 @Transactional 自调用问题
     */
    private fun getSelf(): CopyTradingService {
        return applicationContext?.getBean(CopyTradingService::class.java)
            ?: throw IllegalStateException("ApplicationContext not initialized")
    }
    /**
     * 创建跟单配置
     * 支持两种方式：
@@ -43,16 +67,7 @@ class CopyTradingService(
            val leader = leaderRepository.findById(request.leaderId).orElse(null)
                ?: return Result.failure(IllegalArgumentException("Leader 不存在"))
-            // 3. 检查是否已存在相同的跟单关系（accountId + leaderId）
+            // 3. 验证配置名（强校验：不能为空字符串）
            val existing = copyTradingRepository.findByAccountIdAndLeaderId(
                request.accountId,
                request.leaderId
            )
            if (existing != null) {
                return Result.failure(IllegalArgumentException("该跟单关系已存在"))
            }
            // 4. 验证配置名（强校验：不能为空字符串）
            val configName = request.configName?.trim()
            if (configName.isNullOrBlank()) {
                return Result.failure(IllegalArgumentException("配置名不能为空"))
@@ -82,9 +97,14 @@ class CopyTradingService(
                    supportSell = request.supportSell ?: template.supportSell,
                    minOrderDepth = request.minOrderDepth?.toSafeBigDecimal() ?: template.minOrderDepth,
                    maxSpread = request.maxSpread?.toSafeBigDecimal() ?: template.maxSpread,
                    minOrderbookDepth = request.minOrderbookDepth?.toSafeBigDecimal() ?: template.minOrderbookDepth,
                    minPrice = request.minPrice?.toSafeBigDecimal() ?: template.minPrice,
-                    maxPrice = request.maxPrice?.toSafeBigDecimal() ?: template.maxPrice
+                    maxPrice = request.maxPrice?.toSafeBigDecimal() ?: template.maxPrice,
                    maxPositionValue = request.maxPositionValue?.toSafeBigDecimal(),
                    maxPositionCount = request.maxPositionCount,
                    keywordFilterMode = request.keywordFilterMode ?: "DISABLED",
                    keywords = convertKeywordsToJson(request.keywords),
                    maxMarketEndDate = request.maxMarketEndDate,
                    pushFilteredOrders = request.pushFilteredOrders ?: template.pushFilteredOrders
                )
            } else {
                // 手动输入（所有字段必须提供）
@@ -109,9 +129,14 @@ class CopyTradingService(
                    supportSell = request.supportSell ?: true,
                    minOrderDepth = request.minOrderDepth?.toSafeBigDecimal(),
                    maxSpread = request.maxSpread?.toSafeBigDecimal(),
                    minOrderbookDepth = request.minOrderbookDepth?.toSafeBigDecimal(),
                    minPrice = request.minPrice?.toSafeBigDecimal(),
-                    maxPrice = request.maxPrice?.toSafeBigDecimal()
+                    maxPrice = request.maxPrice?.toSafeBigDecimal(),
                    maxPositionValue = request.maxPositionValue?.toSafeBigDecimal(),
                    maxPositionCount = request.maxPositionCount,
                    keywordFilterMode = request.keywordFilterMode ?: "DISABLED",
                    keywords = convertKeywordsToJson(request.keywords),
                    maxMarketEndDate = request.maxMarketEndDate,
                    pushFilteredOrders = request.pushFilteredOrders ?: false  // 手动输入时使用请求中的值，默认为 false
                )
            }
@@ -136,22 +161,28 @@ class CopyTradingService(
                supportSell = config.supportSell,
                minOrderDepth = config.minOrderDepth,
                maxSpread = config.maxSpread,
                minOrderbookDepth = config.minOrderbookDepth,
                minPrice = config.minPrice,
                maxPrice = config.maxPrice,
                maxPositionValue = config.maxPositionValue,
                maxPositionCount = config.maxPositionCount,
                keywordFilterMode = config.keywordFilterMode,
                keywords = config.keywords,
                configName = configName,
-                pushFailedOrders = request.pushFailedOrders ?: false
+                pushFailedOrders = request.pushFailedOrders ?: false,
                maxMarketEndDate = config.maxMarketEndDate,
                pushFilteredOrders = config.pushFilteredOrders
            )
            val saved = copyTradingRepository.save(copyTrading)
-            // 如果跟单已启用，重新启动监听（确保状态完全同步）
+            // 如果跟单已启用，更新 Leader 监听和账户监听（增量更新，不重启所有监听）
            if (saved.enabled) {
                kotlinx.coroutines.runBlocking {
                    try {
-                        monitorService.restartMonitoring()
+                        monitorService.updateLeaderMonitoring(saved.leaderId)
                        monitorService.updateAccountMonitoring(saved.accountId)
                    } catch (e: Exception) {
-                        logger.error("重新启动跟单监听失败", e)
+                        logger.error("更新监听失败", e)
                    }
                }
            }
@@ -200,24 +231,100 @@ class CopyTradingService(
                websocketReconnectInterval = request.websocketReconnectInterval ?: copyTrading.websocketReconnectInterval,
                websocketMaxRetries = request.websocketMaxRetries ?: copyTrading.websocketMaxRetries,
                supportSell = request.supportSell ?: copyTrading.supportSell,
-                minOrderDepth = request.minOrderDepth?.toSafeBigDecimal() ?: copyTrading.minOrderDepth,
+                // 处理可选字段：空字符串表示要清空（设置为 null），null 表示不更新，转换失败保留旧值
-                maxSpread = request.maxSpread?.toSafeBigDecimal() ?: copyTrading.maxSpread,
+                minOrderDepth = if (request.minOrderDepth != null) {
-                minOrderbookDepth = request.minOrderbookDepth?.toSafeBigDecimal() ?: copyTrading.minOrderbookDepth,
+                    if (request.minOrderDepth.isBlank()) {
-                minPrice = request.minPrice?.toSafeBigDecimal() ?: copyTrading.minPrice,
+                        null
-                maxPrice = request.maxPrice?.toSafeBigDecimal() ?: copyTrading.maxPrice,
+                    } else {
                        val converted = request.minOrderDepth.toSafeBigDecimal()
                        if (converted == IllegalBigDecimal) copyTrading.minOrderDepth else converted
                    }
                } else {
                    copyTrading.minOrderDepth
                },
                maxSpread = if (request.maxSpread != null) {
                    if (request.maxSpread.isBlank()) {
                        null
                    } else {
                        val converted = request.maxSpread.toSafeBigDecimal()
                        if (converted == IllegalBigDecimal) copyTrading.maxSpread else converted
                    }
                } else {
                    copyTrading.maxSpread
                },
                minPrice = if (request.minPrice != null) {
                    if (request.minPrice.isBlank()) {
                        null
                    } else {
                        val converted = request.minPrice.toSafeBigDecimal()
                        if (converted == IllegalBigDecimal) copyTrading.minPrice else converted
                    }
                } else {
                    copyTrading.minPrice
                },
                maxPrice = if (request.maxPrice != null) {
                    if (request.maxPrice.isBlank()) {
                        null
                    } else {
                        val converted = request.maxPrice.toSafeBigDecimal()
                        if (converted == IllegalBigDecimal) copyTrading.maxPrice else converted
                    }
                } else {
                    copyTrading.maxPrice
                },
                maxPositionValue = if (request.maxPositionValue != null) {
                    if (request.maxPositionValue.isBlank()) {
                        null
                    } else {
                        val converted = request.maxPositionValue.toSafeBigDecimal()
                        if (converted == IllegalBigDecimal) copyTrading.maxPositionValue else converted
                    }
                } else {
                    copyTrading.maxPositionValue
                },
                // 处理 maxPositionCount：-1 表示要清空（设置为 null），null 表示不更新
                maxPositionCount = if (request.maxPositionCount != null) {
                    if (request.maxPositionCount == -1) {
                        null
                    } else {
                        request.maxPositionCount
                    }
                } else {
                    copyTrading.maxPositionCount
                },
                keywordFilterMode = request.keywordFilterMode ?: copyTrading.keywordFilterMode,
                keywords = if (request.keywords != null) {
                    convertKeywordsToJson(request.keywords)
                } else if (request.keywordFilterMode != null && request.keywordFilterMode == "DISABLED") {
                    null
                } else {
                    copyTrading.keywords
                },
                configName = configName,
                pushFailedOrders = request.pushFailedOrders ?: copyTrading.pushFailedOrders,
                pushFilteredOrders = request.pushFilteredOrders ?: copyTrading.pushFilteredOrders,
                // 处理 maxMarketEndDate：-1 表示要清空（设置为 null），null 表示不更新
                maxMarketEndDate = if (request.maxMarketEndDate != null) {
                    if (request.maxMarketEndDate == -1L) {
                        null
                    } else {
                        request.maxMarketEndDate
                    }
                } else {
                    copyTrading.maxMarketEndDate
                },
                updatedAt = System.currentTimeMillis()
            )
            val saved = copyTradingRepository.save(updated)
-            // 重新启动监听（确保状态完全同步）
+            // 更新 Leader 监听和账户监听（增量更新，根据 enabled 状态决定添加或移除）
            kotlinx.coroutines.runBlocking {
                try {
-                    monitorService.restartMonitoring()
+                    monitorService.updateLeaderMonitoring(saved.leaderId)
                    monitorService.updateAccountMonitoring(saved.accountId)
                } catch (e: Exception) {
-                    logger.error("重新启动跟单监听失败", e)
+                    logger.error("更新监听失败", e)
                }
            }
@@ -240,7 +347,7 @@ class CopyTradingService(
     */
    @Transactional
    fun updateCopyTradingStatus(request: CopyTradingUpdateStatusRequest): Result<CopyTradingDto> {
-        return updateCopyTrading(
+        return getSelf().updateCopyTrading(
            CopyTradingUpdateRequest(
                copyTradingId = request.copyTradingId,
                enabled = request.enabled
@@ -255,11 +362,10 @@ class CopyTradingService(
        return try {
            val copyTradings = when {
                request.accountId != null && request.leaderId != null -> {
-                    val found = copyTradingRepository.findByAccountIdAndLeaderId(
+                    copyTradingRepository.findByAccountIdAndLeaderId(
                        request.accountId,
                        request.leaderId
                    )
                    if (found != null) listOf(found) else emptyList()
                }
                request.accountId != null -> {
                    copyTradingRepository.findByAccountId(request.accountId)
@@ -315,14 +421,17 @@ class CopyTradingService(
            val copyTrading = copyTradingRepository.findById(copyTradingId).orElse(null)
                ?: return Result.failure(IllegalArgumentException("跟单配置不存在"))
            val leaderId = copyTrading.leaderId
            val accountId = copyTrading.accountId
            copyTradingRepository.delete(copyTrading)
-            // 重新启动监听（确保状态完全同步）
+            // 更新 Leader 监听和账户监听（检查是否还有其他启用的跟单配置）
            kotlinx.coroutines.runBlocking {
                try {
-                    monitorService.restartMonitoring()
+                    monitorService.removeLeaderMonitoring(leaderId)
                    monitorService.updateAccountMonitoring(accountId)
                } catch (e: Exception) {
-                    logger.error("重新启动跟单监听失败", e)
+                    logger.error("更新监听失败", e)
                }
            }
@@ -339,7 +448,7 @@ class CopyTradingService(
    fun getAccountTemplates(accountId: Long): Result<AccountTemplatesResponse> {
        return try {
            // 验证账户是否存在
-            val account = accountRepository.findById(accountId).orElse(null)
+            accountRepository.findById(accountId).orElse(null)
                ?: return Result.failure(IllegalArgumentException("账户不存在"))
            val copyTradings = copyTradingRepository.findByAccountId(accountId)
@@ -380,8 +489,8 @@ class CopyTradingService(
     */
    private fun toDto(
        copyTrading: CopyTrading,
-        account: com.wrbug.polymarketbot.entity.Account,
+        account: Account,
-        leader: com.wrbug.polymarketbot.entity.Leader
+        leader: Leader
    ): CopyTradingDto {
        return CopyTradingDto(
            id = copyTrading.id!!,
@@ -408,16 +517,51 @@ class CopyTradingService(
            supportSell = copyTrading.supportSell,
            minOrderDepth = copyTrading.minOrderDepth?.toPlainString(),
            maxSpread = copyTrading.maxSpread?.toPlainString(),
            minOrderbookDepth = copyTrading.minOrderbookDepth?.toPlainString(),
            minPrice = copyTrading.minPrice?.toPlainString(),
            maxPrice = copyTrading.maxPrice?.toPlainString(),
            maxPositionValue = copyTrading.maxPositionValue?.toPlainString(),
            maxPositionCount = copyTrading.maxPositionCount,
            keywordFilterMode = copyTrading.keywordFilterMode,
            keywords = convertJsonToKeywords(copyTrading.keywords),
            configName = copyTrading.configName,
            pushFailedOrders = copyTrading.pushFailedOrders,
            pushFilteredOrders = copyTrading.pushFilteredOrders,
            maxMarketEndDate = copyTrading.maxMarketEndDate,
            createdAt = copyTrading.createdAt,
            updatedAt = copyTrading.updatedAt
        )
    }
    /**
     * 将关键字列表转换为 JSON 字符串
     */
    private fun convertKeywordsToJson(keywords: List<String>?): String? {
        if (keywords == null || keywords.isEmpty()) {
            return null
        }
        return try {
            gson.toJson(keywords)
        } catch (e: Exception) {
            logger.error("转换关键字列表为 JSON 失败", e)
            null
        }
    }
    /**
     * 将 JSON 字符串转换为关键字列表
     */
    private fun convertJsonToKeywords(jsonString: String?): List<String>? {
        if (jsonString.isNullOrBlank()) {
            return null
        }
        return try {
            jsonUtils.parseStringArray(jsonString)
        } catch (e: Exception) {
            logger.error("解析关键字 JSON 失败", e)
            null
        }
    }
    /**
     * 内部配置类（用于构建 CopyTrading 实体）
     */
@@ -438,8 +582,13 @@ class CopyTradingService(
        val supportSell: Boolean,
        val minOrderDepth: BigDecimal?,
        val maxSpread: BigDecimal?,
        val minOrderbookDepth: BigDecimal?,
        val minPrice: BigDecimal?,
-        val maxPrice: BigDecimal?
+        val maxPrice: BigDecimal?,
        val maxPositionValue: BigDecimal?,
        val maxPositionCount: Int?,
        val keywordFilterMode: String,
        val keywords: String?,  // JSON 字符串
        val maxMarketEndDate: Long?,  // 市场截止时间限制（毫秒时间戳）
        val pushFilteredOrders: Boolean  // 推送已过滤订单（默认关闭）
    )
 }
@@ -0,0 +1,110 @@
 package com.wrbug.polymarketbot.service.copytrading.configs
 import com.wrbug.polymarketbot.api.OrderbookResponse
 /**
 * 过滤结果状态枚举
 */
 enum class FilterStatus {
    /** 通过 */
    PASSED,
    /** 失败：价格区间 */
    FAILED_PRICE_RANGE,
    /** 失败：订单簿获取失败 */
    FAILED_ORDERBOOK_ERROR,
    /** 失败：订单簿为空 */
    FAILED_ORDERBOOK_EMPTY,
    /** 失败：价差过大 */
    FAILED_SPREAD,
    /** 失败：订单深度不足 */
    FAILED_ORDER_DEPTH,
    /** 失败：超过最大仓位金额 */
    FAILED_MAX_POSITION_VALUE,
    /** 失败：超过最大仓位数量 */
    FAILED_MAX_POSITION_COUNT,
    /** 失败：关键字过滤 */
    FAILED_KEYWORD_FILTER,
    /** 失败：市场截止时间超出限制 */
    FAILED_MARKET_END_DATE
 }
 /**
 * 过滤结果
 */
 data class FilterResult(
    /** 过滤状态 */
    val status: FilterStatus,
    /** 失败原因（仅在失败时有效） */
    val reason: String = "",
    /** 订单簿（仅在需要时返回） */
    val orderbook: OrderbookResponse? = null
 ) {
    /** 是否通过 */
    val isPassed: Boolean
        get() = status == FilterStatus.PASSED
    companion object {
        /** 通过 */
        fun passed(orderbook: OrderbookResponse? = null) = FilterResult(
            status = FilterStatus.PASSED,
            orderbook = orderbook
        )
        /** 价格区间失败 */
        fun priceRangeFailed(reason: String) = FilterResult(
            status = FilterStatus.FAILED_PRICE_RANGE,
            reason = reason
        )
        /** 订单簿获取失败 */
        fun orderbookError(reason: String) = FilterResult(
            status = FilterStatus.FAILED_ORDERBOOK_ERROR,
            reason = reason
        )
        /** 订单簿为空 */
        fun orderbookEmpty() = FilterResult(
            status = FilterStatus.FAILED_ORDERBOOK_EMPTY,
            reason = "订单簿为空"
        )
        /** 价差过大 */
        fun spreadFailed(reason: String, orderbook: OrderbookResponse) = FilterResult(
            status = FilterStatus.FAILED_SPREAD,
            reason = reason,
            orderbook = orderbook
        )
        /** 订单深度不足 */
        fun orderDepthFailed(reason: String, orderbook: OrderbookResponse) = FilterResult(
            status = FilterStatus.FAILED_ORDER_DEPTH,
            reason = reason,
            orderbook = orderbook
        )
        /** 超过最大仓位金额 */
        fun maxPositionValueFailed(reason: String) = FilterResult(
            status = FilterStatus.FAILED_MAX_POSITION_VALUE,
            reason = reason
        )
        /** 超过最大仓位数量 */
        fun maxPositionCountFailed(reason: String) = FilterResult(
            status = FilterStatus.FAILED_MAX_POSITION_COUNT,
            reason = reason
        )
        /** 关键字过滤失败 */
        fun keywordFilterFailed(reason: String) = FilterResult(
            status = FilterStatus.FAILED_KEYWORD_FILTER,
            reason = reason
        )
        /** 市场截止时间超出限制 */
        fun marketEndDateFailed(reason: String) = FilterResult(
            status = FilterStatus.FAILED_MARKET_END_DATE,
            reason = reason
        )
    }
 }
@@ -1,4 +1,4 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.copytrading.configs
 import com.wrbug.polymarketbot.dto.FilteredOrderDto
 import com.wrbug.polymarketbot.dto.FilteredOrderListRequest
@@ -1,4 +1,4 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.copytrading.leaders
 import com.wrbug.polymarketbot.dto.*
 import com.wrbug.polymarketbot.entity.Leader
@@ -0,0 +1,341 @@
 package com.wrbug.polymarketbot.service.copytrading.monitor
 import com.wrbug.polymarketbot.api.*
 import com.wrbug.polymarketbot.entity.Account
 import com.wrbug.polymarketbot.entity.CopyOrderTracking
 import com.wrbug.polymarketbot.entity.SellMatchDetail
 import com.wrbug.polymarketbot.entity.SellMatchRecord
 import com.wrbug.polymarketbot.repository.AccountRepository
 import com.wrbug.polymarketbot.repository.CopyOrderTrackingRepository
 import com.wrbug.polymarketbot.repository.CopyTradingRepository
 import com.wrbug.polymarketbot.repository.SellMatchDetailRepository
 import com.wrbug.polymarketbot.repository.SellMatchRecordRepository
 import com.wrbug.polymarketbot.util.RetrofitFactory
 import com.wrbug.polymarketbot.util.multi
 import com.wrbug.polymarketbot.util.toSafeBigDecimal
 import jakarta.annotation.PreDestroy
 import kotlinx.coroutines.*
 import okhttp3.OkHttpClient
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
 import java.math.BigDecimal
 import java.util.concurrent.ConcurrentHashMap
 /**
 * 跟单账户链上 WebSocket 监听服务
 * 通过统一服务订阅跟单账户的卖出和赎回事件
 * 用于更新订单状态，不再依赖轮询
 */
@Service
 class AccountOnChainMonitorService(
    private val unifiedOnChainWsService: UnifiedOnChainWsService,
    private val retrofitFactory: RetrofitFactory,
    private val accountRepository: AccountRepository,
    private val copyTradingRepository: CopyTradingRepository,
    private val copyOrderTrackingRepository: CopyOrderTrackingRepository,
    private val sellMatchRecordRepository: SellMatchRecordRepository,
    private val sellMatchDetailRepository: SellMatchDetailRepository
 ) {
    private val logger = LoggerFactory.getLogger(AccountOnChainMonitorService::class.java)
    // 存储需要监听的账户：accountId -> Account
    private val monitoredAccounts = ConcurrentHashMap<Long, Account>()
    /**
     * 启动链上 WebSocket 监听
     * 通过统一服务订阅所有跟单账户
     */
    fun start(accounts: List<Account>) {
        // 如果没有账户，取消所有订阅
        if (accounts.isEmpty()) {
            logger.info("没有需要监听的跟单账户，取消所有订阅")
            stop()
            return
        }
        // 更新账户列表
        monitoredAccounts.clear()
        accounts.forEach { account ->
            addAccount(account)
        }
    }
    /**
     * 添加账户监听
     * 通过统一服务订阅该账户的地址
     */
    fun addAccount(account: Account) {
        if (account.id == null) {
            logger.warn("账户 ID 为空，跳过: ${account.proxyAddress}")
            return
        }
        val accountId = account.id!!
        // 如果已经在监听列表中，不重复添加
        if (monitoredAccounts.containsKey(accountId)) {
            return
        }
        monitoredAccounts[accountId] = account
        // 通过统一服务订阅
        val subscriptionId = "ACCOUNT_$accountId"
        unifiedOnChainWsService.subscribe(
            subscriptionId = subscriptionId,
            address = account.proxyAddress,
            entityType = "ACCOUNT",
            entityId = accountId,
            callback = { txHash, httpClient, rpcApi ->
                handleAccountTransaction(accountId, txHash, httpClient, rpcApi)
            }
        )
        logger.info("已添加跟单账户进行链上监听: accountId=${accountId}, address=${account.proxyAddress}")
    }
    /**
     * 处理账户的交易
     */
    private suspend fun handleAccountTransaction(accountId: Long, txHash: String, httpClient: OkHttpClient, rpcApi: EthereumRpcApi) {
        val account = monitoredAccounts[accountId] ?: return
        try {
            // 获取交易 receipt
            val receiptRequest = JsonRpcRequest(
                method = "eth_getTransactionReceipt",
                params = listOf(txHash)
            )
            val receiptResponse = rpcApi.call(receiptRequest)
            if (!receiptResponse.isSuccessful || receiptResponse.body() == null) {
                return
            }
            val receiptRpcResponse = receiptResponse.body()!!
            if (receiptRpcResponse.error != null || receiptRpcResponse.result == null || receiptRpcResponse.result.isJsonNull) {
                return
            }
            // 使用 Gson 解析 receipt JSON
            val receiptJson = receiptRpcResponse.result.asJsonObject
            // 获取区块号和时间戳
            val blockNumber = receiptJson.get("blockNumber")?.asString
            val blockTimestamp = if (blockNumber != null) {
                OnChainWsUtils.getBlockTimestamp(blockNumber, rpcApi)
            } else {
                null
            }
            // 解析 receipt 中的 Transfer 日志
            val logs = receiptJson.getAsJsonArray("logs") ?: return
            val (erc20Transfers, erc1155Transfers) = OnChainWsUtils.parseReceiptTransfers(logs)
            // 解析交易信息
            val trade = OnChainWsUtils.parseTradeFromTransfers(
                txHash = txHash,
                timestamp = blockTimestamp,
                walletAddress = account.proxyAddress,
                erc20Transfers = erc20Transfers,
                erc1155Transfers = erc1155Transfers,
                retrofitFactory = retrofitFactory
            )
            if (trade != null && trade.side == "SELL") {
                // 检测到卖出或赎回事件，更新订单状态
                handleAccountSellOrRedeem(account, trade)
            }
        } catch (e: Exception) {
            logger.error("处理账户交易失败: accountId=$accountId, txHash=$txHash, ${e.message}", e)
        }
    }
    /**
     * 处理账户的卖出或赎回事件
     * 更新对应的订单状态
     */
    private suspend fun handleAccountSellOrRedeem(account: Account, trade: TradeResponse) {
        try {
            // 获取该账户的所有启用的跟单配置
            val copyTradings = copyTradingRepository.findByAccountId(account.id!!)
                .filter { it.enabled }
            if (copyTradings.isEmpty()) {
                return
            }
            // 使用 trade 中已有的市场信息
            val marketId = trade.market  // conditionId
            val outcomeIndex = trade.outcomeIndex ?: 0
            // 计算卖出价格
            val sellPrice = trade.price.toSafeBigDecimal()
            // 为每个跟单配置更新订单状态
            for (copyTrading in copyTradings) {
                // 查找该跟单配置下所有未卖出的订单（remaining_quantity > 0）
                val unmatchedOrders = copyOrderTrackingRepository.findByCopyTradingId(copyTrading.id!!)
                    .filter { 
                        it.remainingQuantity > BigDecimal.ZERO &&
                        it.marketId == marketId &&
                        it.outcomeIndex == outcomeIndex
                    }
                    .sortedBy { it.createdAt }  // 按创建时间排序（FIFO）
                if (unmatchedOrders.isEmpty()) {
                    continue
                }
                // 卖出数量就是交易的 size
                val soldQuantity = trade.size.toSafeBigDecimal()
                // 更新订单状态为已卖出
                updateOrdersAsSoldByFIFO(
                    unmatchedOrders,
                    soldQuantity,
                    sellPrice,
                    copyTrading.id!!,
                    marketId,
                    outcomeIndex
                )
                logger.info("跟单账户卖出/赎回事件处理完成: accountId=${account.id}, copyTradingId=${copyTrading.id}, txHash=${trade.id}, soldQuantity=$soldQuantity, sellPrice=$sellPrice")
            }
        } catch (e: Exception) {
            logger.error("处理账户卖出/赎回事件失败: accountId=${account.id}, txHash=${trade.id}, error=${e.message}", e)
        }
    }
    /**
     * 按 FIFO 顺序更新订单为已卖出
     */
    private suspend fun updateOrdersAsSoldByFIFO(
        orders: List<CopyOrderTracking>,
        soldQuantity: BigDecimal,
        sellPrice: BigDecimal,
        copyTradingId: Long,
        marketId: String,
        outcomeIndex: Int
    ) {
        var remainingSoldQuantity = soldQuantity
        val matchDetails = mutableListOf<SellMatchDetail>()
        var totalMatchedQuantity = BigDecimal.ZERO
        var totalRealizedPnl = BigDecimal.ZERO
        for (order in orders) {
            if (remainingSoldQuantity <= BigDecimal.ZERO) {
                break
            }
            val currentOrderRemaining = order.remainingQuantity.toSafeBigDecimal()
            val matchedQty = minOf(currentOrderRemaining, remainingSoldQuantity)
            if (matchedQty <= BigDecimal.ZERO) {
                continue
            }
            // 计算盈亏
            val buyPrice = order.price.toSafeBigDecimal()
            val realizedPnl = sellPrice.subtract(buyPrice).multi(matchedQty)
            // 创建匹配明细
            val detail = SellMatchDetail(
                matchRecordId = 0, // 稍后设置
                trackingId = order.id!!,
                buyOrderId = order.buyOrderId,
                matchedQuantity = matchedQty,
                buyPrice = buyPrice,
                sellPrice = sellPrice,
                realizedPnl = realizedPnl
            )
            matchDetails.add(detail)
            totalMatchedQuantity = totalMatchedQuantity.add(matchedQty)
            totalRealizedPnl = totalRealizedPnl.add(realizedPnl)
            // 更新订单状态
            order.matchedQuantity = order.matchedQuantity.add(matchedQty)
            order.remainingQuantity = currentOrderRemaining.subtract(matchedQty)
            order.status = if (order.remainingQuantity <= BigDecimal.ZERO) "fully_matched" else "partially_matched"
            order.updatedAt = System.currentTimeMillis()
            copyOrderTrackingRepository.save(order)
            remainingSoldQuantity = remainingSoldQuantity.subtract(matchedQty)
        }
        // 如果有匹配的订单，创建卖出记录
        if (totalMatchedQuantity > BigDecimal.ZERO && matchDetails.isNotEmpty()) {
            val timestamp = System.currentTimeMillis()
            val sellOrderId = "AUTO_WS_${timestamp}_${copyTradingId}" // 区分 WS 自动卖出
            val leaderSellTradeId = "AUTO_WS_${timestamp}"
            val matchRecord = SellMatchRecord(
                copyTradingId = copyTradingId,
                sellOrderId = sellOrderId,
                leaderSellTradeId = leaderSellTradeId,
                marketId = marketId,
                side = outcomeIndex.toString(),
                outcomeIndex = outcomeIndex,
                totalMatchedQuantity = totalMatchedQuantity,
                sellPrice = sellPrice,
                totalRealizedPnl = totalRealizedPnl,
                priceUpdated = true // WS 实时获取，直接标记为已更新
            )
            val savedRecord = sellMatchRecordRepository.save(matchRecord)
            // 保存匹配明细
            for (detail in matchDetails) {
                val savedDetail = detail.copy(matchRecordId = savedRecord.id!!)
                sellMatchDetailRepository.save(savedDetail)
            }
            logger.info("创建跟单账户链上自动卖出记录: copyTradingId=$copyTradingId, marketId=$marketId, totalMatched=$totalMatchedQuantity, totalPnl=$totalRealizedPnl")
        }
    }
    /**
     * 移除账户监听
     * 取消该账户的订阅
     */
    fun removeAccount(accountId: Long) {
        monitoredAccounts.remove(accountId)
        // 通过统一服务取消订阅
        val subscriptionId = "ACCOUNT_$accountId"
        unifiedOnChainWsService.unsubscribe(subscriptionId)
        logger.info("已移除跟单账户的链上监听: accountId=$accountId")
    }
    /**
     * 更新账户监听状态
     */
    fun updateAccountMonitoring(accountId: Long) {
        val account = accountRepository.findById(accountId).orElse(null)
        if (account != null && account.isEnabled) {
            addAccount(account)
        } else {
            removeAccount(accountId)
        }
    }
    /**
     * 停止监听
     */
    fun stop() {
        // 取消所有账户的订阅
        val accountIds = monitoredAccounts.keys.toList()
        for (accountId in accountIds) {
            removeAccount(accountId)
        }
        monitoredAccounts.clear()
    }
    @PreDestroy
    fun destroy() {
        stop()
    }
 }
@@ -0,0 +1,193 @@
 package com.wrbug.polymarketbot.service.copytrading.monitor
 import com.wrbug.polymarketbot.entity.CopyTrading
 import com.wrbug.polymarketbot.entity.Leader
 import com.wrbug.polymarketbot.repository.AccountRepository
 import com.wrbug.polymarketbot.repository.CopyTradingRepository
 import com.wrbug.polymarketbot.repository.LeaderRepository
 import jakarta.annotation.PostConstruct
 import jakarta.annotation.PreDestroy
 import kotlinx.coroutines.*
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
 /**
 * 跟单监听服务（主服务）
 * 管理所有Leader的交易监听
 * 使用双重监听机制：
 * 1. Activity WebSocket - 低延迟（< 100ms），优先使用
 * 2. OnChain WebSocket - 高可靠性（~2-3s），作为兜底
 * 同时监听跟单账户的卖出/赎回事件（通过链上 WebSocket）
 */
@Service
 class CopyTradingMonitorService(
    private val copyTradingRepository: CopyTradingRepository,
    private val leaderRepository: LeaderRepository,
    private val accountRepository: AccountRepository,
    private val activityWsService: PolymarketActivityWsService,
    private val onChainWsService: OnChainWsService,
    private val accountOnChainMonitorService: AccountOnChainMonitorService
 ) {
    private val logger = LoggerFactory.getLogger(CopyTradingMonitorService::class.java)
    private val scope = CoroutineScope(Dispatchers.Default + SupervisorJob())
    /**
     * 系统启动时初始化监听
     */
    @PostConstruct
    fun init() {
        scope.launch {
            try {
                startMonitoring()
            } catch (e: Exception) {
                logger.error("启动跟单监听失败", e)
            }
        }
    }
    /**
     * 系统关闭时清理资源
     */
    @PreDestroy
    fun destroy() {
        scope.cancel()
        // 停止所有监听
        activityWsService.stop()
        onChainWsService.stop()
        accountOnChainMonitorService.stop()
    }
    /**
     * 启动监听
     * 启动双重监听机制：
     * 1. Activity WebSocket - 低延迟（< 100ms），优先使用
     * 2. OnChain WebSocket - 高可靠性（~2-3s），作为兜底
     * 同时启动跟单账户的链上 WebSocket 监听（用于检测卖出/赎回事件）
     */
    suspend fun startMonitoring() {
        // 1. 获取所有启用的跟单关系
        val enabledCopyTradings = copyTradingRepository.findByEnabledTrue()
        if (enabledCopyTradings.isEmpty()) {
            return
        }
        // 2. 获取所有需要监听的Leader（去重）
        val leaderIds = enabledCopyTradings.map { it.leaderId }.distinct()
        val leaders = leaderIds.mapNotNull { leaderId ->
            leaderRepository.findById(leaderId).orElse(null)
        }
        // 3. 获取所有需要监听的跟单账户（去重）
        val accountIds = enabledCopyTradings.map { it.accountId }.distinct()
        val accounts = accountIds.mapNotNull { accountId ->
            accountRepository.findById(accountId).orElse(null)
        }
        // 4. 启动 Activity WebSocket 监听（优先，低延迟）
        activityWsService.start(leaders)
        // 5. 启动链上 WebSocket 监听（兜底，高可靠性）
        onChainWsService.start(leaders)
        // 6. 启动跟单账户的链上 WebSocket 监听（用于检测卖出/赎回事件）
        accountOnChainMonitorService.start(accounts)
    }
    /**
     * 添加Leader监听（当创建新的跟单关系时调用）
     * 如果 Leader 已经在监听列表中，不重复添加
     */
    suspend fun addLeaderMonitoring(leaderId: Long) {
        val leader = leaderRepository.findById(leaderId).orElse(null)
            ?: return
        val copyTradings = copyTradingRepository.findByLeaderIdAndEnabledTrue(leaderId)
        if (copyTradings.isEmpty()) {
            return
        }
        // 同时添加到两种监听
        activityWsService.addLeader(leader)
        onChainWsService.addLeader(leader)
    }
    /**
     * 移除Leader监听（当删除跟单关系或禁用时调用）
     * 检查该 Leader 是否还有其他启用的跟单配置
     */
    suspend fun removeLeaderMonitoring(leaderId: Long) {
        val copyTradings = copyTradingRepository.findByLeaderIdAndEnabledTrue(leaderId)
        // 如果还有启用的跟单配置，不移除监听
        if (copyTradings.isNotEmpty()) {
            return
        }
        // 没有启用的跟单配置了，同时从两种监听移除
        activityWsService.removeLeader(leaderId)
        onChainWsService.removeLeader(leaderId)
    }
    /**
     * 更新Leader监听（当跟单配置状态改变时调用）
     * 根据当前状态决定添加或移除监听
     */
    suspend fun updateLeaderMonitoring(leaderId: Long) {
        val copyTradings = copyTradingRepository.findByLeaderIdAndEnabledTrue(leaderId)
        val leader = leaderRepository.findById(leaderId).orElse(null)
            ?: return
        if (copyTradings.isNotEmpty()) {
            // 有启用的跟单配置，确保在监听列表中
            activityWsService.addLeader(leader)
            onChainWsService.addLeader(leader)
            // 更新账户监听（添加该配置关联的账户）
            val accountIds = copyTradings.map { it.accountId }.distinct()
            accountIds.forEach { accountId ->
                val account = accountRepository.findById(accountId).orElse(null)
                if (account != null) {
                    accountOnChainMonitorService.addAccount(account)
                }
            }
        } else {
            // 没有启用的跟单配置，同时从两种监听移除
            activityWsService.removeLeader(leaderId)
            onChainWsService.removeLeader(leaderId)
        }
    }
    /**
     * 更新账户监听（当跟单配置状态改变时调用）
     * 根据当前状态决定添加或移除账户监听
     */
    suspend fun updateAccountMonitoring(accountId: Long) {
        val copyTradings = copyTradingRepository.findByAccountId(accountId)
            .filter { it.enabled }
        val account = accountRepository.findById(accountId).orElse(null)
            ?: return
        if (copyTradings.isNotEmpty()) {
            // 有启用的跟单配置，确保账户在监听列表中
            accountOnChainMonitorService.addAccount(account)
        } else {
            // 没有启用的跟单配置，移除账户监听
            accountOnChainMonitorService.removeAccount(accountId)
        }
    }
    /**
     * 重新启动监听（当跟单关系状态改变时调用）
     * 注意：这个方法会停止所有监听并重新启动，建议使用 updateLeaderMonitoring 进行增量更新
     */
    suspend fun restartMonitoring() {
        // 停止所有监听
        activityWsService.stop()
        onChainWsService.stop()
        delay(1000)  // 等待1秒
        startMonitoring()
    }
 }
@@ -1,4 +1,4 @@
-package com.wrbug.polymarketbot.service
+package com.wrbug.polymarketbot.service.copytrading.monitor
 import com.google.gson.Gson
 import com.google.gson.JsonObject
@@ -9,8 +9,9 @@ import com.wrbug.polymarketbot.repository.CopyTradingTemplateRepository
 import com.wrbug.polymarketbot.websocket.PolymarketWebSocketClient
 import jakarta.annotation.PreDestroy
 import kotlinx.coroutines.*
 import com.wrbug.polymarketbot.constants.PolymarketConstants
 import org.slf4j.LoggerFactory
-import org.springframework.beans.factory.annotation.Value
+import com.wrbug.polymarketbot.service.copytrading.statistics.CopyOrderTrackingService
 import org.springframework.stereotype.Service
 import java.util.concurrent.ConcurrentHashMap
@@ -21,15 +22,13 @@ import java.util.concurrent.ConcurrentHashMap
@Service
 class CopyTradingWebSocketService(
    private val copyOrderTrackingService: CopyOrderTrackingService,
-    private val templateRepository: CopyTradingTemplateRepository
+    private val templateRepository: CopyTradingTemplateRepository,
    private val gson: Gson
 ) {
    private val logger = LoggerFactory.getLogger(CopyTradingWebSocketService::class.java)
-    @Value("\${polymarket.websocket.url:wss://ws-live-data.polymarket.com}")
+    private val websocketUrl: String = PolymarketConstants.USER_WS_URL
    private var websocketUrl: String = "wss://ws-live-data.polymarket.com"
    private val gson = Gson()
    private val scope = CoroutineScope(Dispatchers.Default + SupervisorJob())
    // 存储每个Leader的WebSocket客户端：leaderId -> WebSocketClient
@@ -65,7 +64,7 @@ class CopyTradingWebSocketService(
            return
        }
-        val leaderId = leader.id!!
+        val leaderId = leader.id
        val leaderAddress = leader.leaderAddress.lowercase()
        leaderAddresses[leaderId] = leaderAddress
@@ -214,7 +213,7 @@ class CopyTradingWebSocketService(
                // 处理交易
                scope.launch {
                    try {
-                        copyOrderTrackingService.processTrade(leaderId, trade, "websocket")
+                        copyOrderTrackingService.processTrade(leaderId, trade, "activity-ws")
                    } catch (e: Exception) {
                        logger.error("处理交易失败: leaderId=$leaderId, tradeId=${trade.id}", e)
                    }
@@ -0,0 +1,210 @@
 package com.wrbug.polymarketbot.service.copytrading.monitor
 import com.github.benmanes.caffeine.cache.Cache
 import com.github.benmanes.caffeine.cache.Caffeine
 import com.google.gson.JsonNull
 import com.wrbug.polymarketbot.api.*
 import com.wrbug.polymarketbot.entity.Leader
 import com.wrbug.polymarketbot.repository.LeaderRepository
 import com.wrbug.polymarketbot.service.copytrading.statistics.CopyOrderTrackingService
 import com.wrbug.polymarketbot.util.RetrofitFactory
 import jakarta.annotation.PreDestroy
 import kotlinx.coroutines.*
 import okhttp3.OkHttpClient
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
 import java.util.concurrent.ConcurrentHashMap
 import java.util.concurrent.TimeUnit
 /**
 * 链上 WebSocket 监听服务
 * 通过统一服务订阅 Leader 的链上交易
 */
@Service
 class OnChainWsService(
    private val unifiedOnChainWsService: UnifiedOnChainWsService,
    private val retrofitFactory: RetrofitFactory,
    private val copyOrderTrackingService: CopyOrderTrackingService,
    private val leaderRepository: LeaderRepository
 ) {
    private val logger = LoggerFactory.getLogger(OnChainWsService::class.java)
    // 存储需要监听的Leader：leaderId -> Leader
    private val monitoredLeaders = ConcurrentHashMap<Long, Leader>()
    // 存储已处理的交易哈希，用于去重（LRU 缓存，保留最近 100 条）
    private val processedTxHashes: Cache<String, Long> = Caffeine.newBuilder()
        .maximumSize(100)
        .build()
    /**
     * 启动链上 WebSocket 监听
     * 通过统一服务订阅所有 Leader
     */
    fun start(leaders: List<Leader>) {
        // 如果没有 Leader，取消所有订阅
        if (leaders.isEmpty()) {
            logger.info("没有需要监听的 Leader，取消所有订阅")
            stop()
            return
        }
        // 更新 Leader 列表
        monitoredLeaders.clear()
        leaders.forEach { leader ->
            addLeader(leader)
        }
    }
    /**
     * 添加Leader监听
     * 通过统一服务订阅该 Leader 的地址
     */
    fun addLeader(leader: Leader) {
        if (leader.id == null) {
            logger.warn("Leader ID为空，跳过: ${leader.leaderAddress}")
            return
        }
        val leaderId = leader.id!!
        // 如果已经在监听列表中，不重复添加
        if (monitoredLeaders.containsKey(leaderId)) {
            logger.debug("Leader 已在监听列表中: ${leader.leaderName} (${leader.leaderAddress})")
            return
        }
        monitoredLeaders[leaderId] = leader
        // 通过统一服务订阅
        val subscriptionId = "LEADER_$leaderId"
        unifiedOnChainWsService.subscribe(
            subscriptionId = subscriptionId,
            address = leader.leaderAddress,
            entityType = "LEADER",
            entityId = leaderId,
            callback = { txHash, httpClient, rpcApi ->
                handleLeaderTransaction(leaderId, txHash, httpClient, rpcApi)
            }
        )
        logger.info("添加 Leader 监听: ${leader.leaderName} (${leader.leaderAddress})")
    }
    /**
     * 处理 Leader 的交易
     */
    private suspend fun handleLeaderTransaction(
        leaderId: Long,
        txHash: String,
        httpClient: OkHttpClient,
        rpcApi: EthereumRpcApi
    ) {
        val leader = monitoredLeaders[leaderId] ?: return
        // 根据 txHash 去重（使用原子操作避免竞态条件）
        val currentTime = System.currentTimeMillis()
        val existingTimestamp = processedTxHashes.asMap().putIfAbsent(txHash, currentTime)
        if (existingTimestamp != null) {
            logger.debug("交易已处理过，跳过: leaderId=$leaderId, txHash=$txHash, firstProcessedAt=$existingTimestamp")
            return
        }
        logger.debug("开始处理 Leader 交易: leaderId=$leaderId, txHash=$txHash, leaderAddress=${leader.leaderAddress}")
        try {
            // 获取交易 receipt
            val receiptRequest = JsonRpcRequest(
                method = "eth_getTransactionReceipt",
                params = listOf(txHash)
            )
            val receiptResponse = rpcApi.call(receiptRequest)
            if (!receiptResponse.isSuccessful || receiptResponse.body() == null) {
                logger.warn("获取交易 receipt 失败: leaderId=$leaderId, txHash=$txHash, code=${receiptResponse.code()}")
                return
            }
            val receiptRpcResponse = receiptResponse.body()!!
            if (receiptRpcResponse.error != null || receiptRpcResponse.result == null || receiptRpcResponse.result is JsonNull) {
                logger.warn("交易 receipt 错误: leaderId=$leaderId, txHash=$txHash, error=${receiptRpcResponse.error}")
                return
            }
            // 使用 Gson 解析 receipt JSON
            val receiptJson = receiptRpcResponse.result.asJsonObject
            // 获取区块号和时间戳
            val blockNumber = receiptJson.get("blockNumber")?.asString
            val blockTimestamp = if (blockNumber != null) {
                OnChainWsUtils.getBlockTimestamp(blockNumber, rpcApi)
            } else {
                null
            }
            // 解析 receipt 中的 Transfer 日志
            val logs = receiptJson.getAsJsonArray("logs") ?: run {
                logger.warn("交易 receipt 中没有日志: leaderId=$leaderId, txHash=$txHash")
                return
            }
            val (erc20Transfers, erc1155Transfers) = OnChainWsUtils.parseReceiptTransfers(logs)
            logger.debug("解析交易日志: leaderId=$leaderId, txHash=$txHash, erc20Transfers=${erc20Transfers.size}, erc1155Transfers=${erc1155Transfers.size}")
            // 解析交易信息
            val trade = OnChainWsUtils.parseTradeFromTransfers(
                txHash = txHash,
                timestamp = blockTimestamp,
                walletAddress = leader.leaderAddress,
                erc20Transfers = erc20Transfers,
                erc1155Transfers = erc1155Transfers,
                retrofitFactory = retrofitFactory
            )
            if (trade != null) {
                logger.info("成功解析交易: leaderId=$leaderId, txHash=$txHash, side=${trade.side}, market=${trade.market}, size=${trade.size}")
                // 调用 processTrade 处理交易
                copyOrderTrackingService.processTrade(
                    leaderId = leaderId,
                    trade = trade,
                    source = "onchain-ws"
                )
            } else {
                logger.warn("无法解析交易（返回 null）: leaderId=$leaderId, txHash=$txHash, erc20Transfers=${erc20Transfers.size}, erc1155Transfers=${erc1155Transfers.size}")
            }
        } catch (e: Exception) {
            logger.error("处理 Leader 交易失败: leaderId=$leaderId, txHash=$txHash, ${e.message}", e)
        }
    }
    /**
     * 移除Leader监听
     * 取消该 Leader 的订阅
     */
    fun removeLeader(leaderId: Long) {
        monitoredLeaders.remove(leaderId)
        // 通过统一服务取消订阅
        val subscriptionId = "LEADER_$leaderId"
        unifiedOnChainWsService.unsubscribe(subscriptionId)
        logger.info("移除 Leader 监听: leaderId=$leaderId")
    }
    /**
     * 停止监听
     */
    fun stop() {
        // 取消所有 Leader 的订阅
        val leaderIds = monitoredLeaders.keys.toList()
        for (leaderId in leaderIds) {
            removeLeader(leaderId)
        }
        monitoredLeaders.clear()
    }
    @PreDestroy
    fun destroy() {
        stop()
    }
 }
@@ -0,0 +1,378 @@
 package com.wrbug.polymarketbot.service.copytrading.monitor
 import com.google.gson.Gson
 import com.google.gson.GsonBuilder
 import com.google.gson.JsonArray
 import com.google.gson.reflect.TypeToken
 import com.wrbug.polymarketbot.api.*
 import com.wrbug.polymarketbot.service.system.RpcNodeService
 import com.wrbug.polymarketbot.util.RetrofitFactory
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.withContext
 import okhttp3.OkHttpClient
 import org.slf4j.LoggerFactory
 import java.math.BigInteger
 /**
 * 链上 WebSocket 工具类
 * 提取公共的交易解析、工具函数等逻辑
 */
 object OnChainWsUtils {
    private val logger = LoggerFactory.getLogger(OnChainWsUtils::class.java)
    // 创建 Gson 实例（与 GsonConfig 中的配置一致，使用 lenient 模式）
    private val gson: Gson = GsonBuilder()
        .setLenient()
        .create()
    /**
     * 解析 JSON 字符串数组
     * @param jsonString JSON 字符串，如 "[\"Yes\", \"No\"]"
     * @return 字符串列表，如果解析失败返回空列表
     */
    private fun parseStringArray(jsonString: String?): List<String> {
        if (jsonString.isNullOrBlank()) {
            return emptyList()
        }
        return try {
            val listType = object : TypeToken<List<String>>() {}.type
            gson.fromJson<List<String>>(jsonString, listType) ?: emptyList()
        } catch (e: Exception) {
            emptyList()
        }
    }
    // 合约地址
    const val USDC_CONTRACT = "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174"
    const val ERC1155_CONTRACT = "0x4d97dcd97ec945f40cf65f87097ace5ea0476045"
    const val ERC20_TRANSFER_TOPIC = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
    const val ERC1155_TRANSFER_SINGLE_TOPIC = "0xc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62"
    const val ERC1155_TRANSFER_BATCH_TOPIC = "0x4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb"
    /**
     * ERC20 Transfer 数据类
     */
    data class Erc20Transfer(
        val from: String,
        val to: String,
        val value: BigInteger
    )
    /**
     * ERC1155 Transfer 数据类
     */
    data class Erc1155Transfer(
        val from: String,
        val to: String,
        val tokenId: BigInteger,
        val value: BigInteger
    )
    /**
     * 市场信息数据类
     */
    data class MarketInfo(
        val conditionId: String,
        val outcomeIndex: Int?,  // 可空，因为可能找不到对应的 tokenId
        val outcome: String?
    )
    /**
     * 解析 receipt 中的 Transfer 日志
     */
    fun parseReceiptTransfers(logs: JsonArray): Pair<List<Erc20Transfer>, List<Erc1155Transfer>> {
        val erc20 = mutableListOf<Erc20Transfer>()
        val erc1155 = mutableListOf<Erc1155Transfer>()
        for (logElement in logs) {
            val log = logElement.asJsonObject
            val address = log.get("address")?.asString?.lowercase() ?: continue
            val topicsArray = log.getAsJsonArray("topics") ?: continue
            val topics = topicsArray.mapNotNull { it.asString }
            if (topics.isEmpty()) continue
            val t0 = topics[0].lowercase()
            val data = log.get("data")?.asString ?: "0x"
            // USDC ERC20 Transfer
            if (address == USDC_CONTRACT.lowercase() && t0 == ERC20_TRANSFER_TOPIC && topics.size >= 3) {
                val from = topicToAddress(topics[1])
                val to = topicToAddress(topics[2])
                val value = hexToBigInt(data)
                erc20.add(Erc20Transfer(from, to, value))
                continue
            }
            // ERC1155 TransferSingle
            if (t0 == ERC1155_TRANSFER_SINGLE_TOPIC && topics.size >= 4) {
                val from = topicToAddress(topics[2])
                val to = topicToAddress(topics[3])
                val bytes = bytesFromHex(data)
                if (bytes.size >= 64) {
                    val tokenId = sliceBigInt32(bytes, 0)
                    val value = sliceBigInt32(bytes, 32)
                    erc1155.add(Erc1155Transfer(from, to, tokenId, value))
                }
                continue
            }
            // ERC1155 TransferBatch
            if (t0 == ERC1155_TRANSFER_BATCH_TOPIC && topics.size >= 4) {
                val from = topicToAddress(topics[2])
                val to = topicToAddress(topics[3])
                val bytes = bytesFromHex(data)
                if (bytes.size < 64) continue
                val offIds = sliceBigInt32(bytes, 0).toInt()
                val offVals = sliceBigInt32(bytes, 32).toInt()
                if (offIds + 32 > bytes.size || offVals + 32 > bytes.size) continue
                val nIds = sliceBigInt32(bytes, offIds).toInt()
                val nVals = sliceBigInt32(bytes, offVals).toInt()
                if (nIds != nVals) continue
                val idsStart = offIds + 32
                val valsStart = offVals + 32
                for (i in 0 until nIds) {
                    val ib = idsStart + i * 32
                    val vb = valsStart + i * 32
                    if (ib + 32 > bytes.size || vb + 32 > bytes.size) break
                    val tokenId = sliceBigInt32(bytes, ib)
                    val value = sliceBigInt32(bytes, vb)
                    erc1155.add(Erc1155Transfer(from, to, tokenId, value))
                }
            }
        }
        return Pair(erc20, erc1155)
    }
    /**
     * 从 Transfer 日志解析交易信息
     */
    suspend fun parseTradeFromTransfers(
        txHash: String,
        timestamp: Long?,
        walletAddress: String,
        erc20Transfers: List<Erc20Transfer>,
        erc1155Transfers: List<Erc1155Transfer>,
        retrofitFactory: RetrofitFactory
    ): TradeResponse? {
        val wallet = walletAddress.lowercase()
        // 计算 USDC 流入和流出
        val usdcOut = erc20Transfers.filter { it.from.lowercase() == wallet }
            .fold(BigInteger.ZERO) { acc, t -> acc + t.value }
        val usdcIn = erc20Transfers.filter { it.to.lowercase() == wallet }
            .fold(BigInteger.ZERO) { acc, t -> acc + t.value }
        // 计算 ERC1155 流入和流出（按 tokenId 聚合）
        val inById = mutableMapOf<BigInteger, BigInteger>()
        val outById = mutableMapOf<BigInteger, BigInteger>()
        for (t in erc1155Transfers) {
            if (t.to.lowercase() == wallet) {
                inById[t.tokenId] = (inById[t.tokenId] ?: BigInteger.ZERO) + t.value
            }
            if (t.from.lowercase() == wallet) {
                outById[t.tokenId] = (outById[t.tokenId] ?: BigInteger.ZERO) + t.value
            }
        }
        // 找到最大的流入和流出 tokenId
        fun best(map: Map<BigInteger, BigInteger>): Pair<BigInteger?, BigInteger> =
            map.entries.maxByOrNull { it.value }?.let { it.key to it.value } ?: (null to BigInteger.ZERO)
        val (bestInId, bestInVal) = best(inById)
        val (bestOutId, bestOutVal) = best(outById)
        // 判断交易方向
        var side: String? = null
        var asset: BigInteger? = null
        var sizeRaw = BigInteger.ZERO
        var usdcRaw = BigInteger.ZERO
        if (bestInId != null && bestInVal > BigInteger.ZERO && usdcOut > BigInteger.ZERO) {
            // BUY: 收到 token，支付 USDC
            side = "BUY"
            asset = bestInId
            sizeRaw = bestInVal
            usdcRaw = usdcOut
        } else if (bestOutId != null && bestOutVal > BigInteger.ZERO && usdcIn > BigInteger.ZERO) {
            // SELL: 卖出 token，收到 USDC
            side = "SELL"
            asset = bestOutId
            sizeRaw = bestOutVal
            usdcRaw = usdcIn
        } else {
            // 无法判断交易方向
            logger.debug("无法判断交易方向: txHash=$txHash, bestInId=$bestInId, bestInVal=$bestInVal, bestOutId=$bestOutId, bestOutVal=$bestOutVal, usdcOut=$usdcOut, usdcIn=$usdcIn")
            return null
        }
        // 计算价格和数量（USDC 有 6 位小数，shares 也有 6 位小数）
        val usdcSize = usdcRaw.toBigDecimal().divide(BigInteger("1000000").toBigDecimal(), 8, java.math.RoundingMode.DOWN)
        val size = sizeRaw.toBigDecimal().divide(BigInteger("1000000").toBigDecimal(), 8, java.math.RoundingMode.DOWN)
        val price = if (size.signum() > 0) {
            usdcSize.divide(size, 8, java.math.RoundingMode.DOWN)
        } else {
            return null
        }
        // 尝试通过 Gamma API 查询市场信息（通过 tokenId）
        val marketInfo = fetchMarketByTokenId(asset.toString(), retrofitFactory)
        // 创建 TradeResponse
        return TradeResponse(
            id = txHash,
            market = marketInfo?.conditionId ?: "",
            side = side,
            price = price.toPlainString(),
            size = size.toPlainString(),
            timestamp = (timestamp ?: System.currentTimeMillis() / 1000).toString(),
            user = walletAddress,
            outcomeIndex = marketInfo?.outcomeIndex,
            outcome = marketInfo?.outcome
        )
    }
    /**
     * 通过 Gamma API 查询市场信息（通过 tokenId）
     * 使用 Retrofit 接口，支持 clob_token_ids 参数
     */
    suspend fun fetchMarketByTokenId(tokenId: String, retrofitFactory: RetrofitFactory): MarketInfo? {
        return try {
            val gammaApi = retrofitFactory.createGammaApi()
            val marketsResponse = gammaApi.listMarkets(
                conditionIds = null,
                clobTokenIds = listOf(tokenId),
                includeTag = null
            )
            if (!marketsResponse.isSuccessful || marketsResponse.body() == null) {
                return null
            }
            val markets = marketsResponse.body()!!
            val market = markets.firstOrNull()
            if (market == null) {
                return null
            }
            // 解析 clobTokenIds（可能是 JSON 字符串或数组）
            val clobTokenIdsRaw = market.clobTokenIds ?: market.clob_token_ids
            val clobTokenIds = when {
                clobTokenIdsRaw == null -> null
                else -> {
                    // 解析 JSON 字符串
                    parseStringArray(clobTokenIdsRaw)
                }
            }
            // 解析 outcomes（可能是 JSON 字符串或数组）
            val outcomes = parseStringArray(market.outcomes)
            // 查找 tokenId 在 clobTokenIds 中的索引
            val outcomeIndex = clobTokenIds?.indexOfFirst { token ->
                token.equals(tokenId, ignoreCase = true)
            }?.takeIf { it >= 0 }
            // 获取 outcome 名称
            val outcome = if (outcomeIndex != null && outcomes.isNotEmpty() && outcomeIndex < outcomes.size) {
                outcomes[outcomeIndex]
            } else {
                null
            }
            val conditionId = market.conditionId ?: return null
            MarketInfo(
                conditionId = conditionId,
                outcomeIndex = outcomeIndex,
                outcome = outcome
            )
        } catch (e: Exception) {
            logger.warn("查询市场信息失败: tokenId=$tokenId, error=${e.message}")
            null
        }
    }
    /**
     * 获取区块时间戳
     */
    suspend fun getBlockTimestamp(blockNumber: String, rpcApi: EthereumRpcApi): Long? {
        return try {
            val blockRequest = JsonRpcRequest(
                method = "eth_getBlockByNumber",
                params = listOf(blockNumber, false)
            )
            val blockResponse = rpcApi.call(blockRequest)
            if (blockResponse.isSuccessful && blockResponse.body() != null) {
                val blockRpcResponse = blockResponse.body()!!
                if (blockRpcResponse.error == null && blockRpcResponse.result != null) {
                    val blockJson = blockRpcResponse.result.asJsonObject
                    val timestampHex = blockJson.get("timestamp")?.asString
                    if (timestampHex != null) {
                        BigInteger(timestampHex.removePrefix("0x"), 16).toLong() * 1000  // 转换为毫秒
                    } else {
                        null
                    }
                } else {
                    null
                }
            } else {
                null
            }
        } catch (e: Exception) {
            logger.warn("获取区块时间戳失败: blockNumber=$blockNumber, error=${e.message}")
            null
        }
    }
    /**
     * 工具函数：地址转 topic（32字节，左对齐）
     */
    fun addressToTopic32(address: String): String {
        val clean = address.removePrefix("0x").lowercase()
        return "0x" + clean.padStart(64, '0')
    }
    /**
     * 工具函数：topic 转地址
     */
    fun topicToAddress(topic: String): String {
        val clean = topic.removePrefix("0x").lowercase()
        return "0x" + clean.takeLast(40)
    }
    /**
     * 工具函数：十六进制转 BigInteger
     */
    fun hexToBigInt(hex: String): BigInteger {
        val clean = hex.removePrefix("0x")
        return if (clean.isBlank()) BigInteger.ZERO else BigInteger(clean, 16)
    }
    /**
     * 工具函数：十六进制转字节数组
     */
    fun bytesFromHex(hex: String): ByteArray {
        val clean = hex.removePrefix("0x")
        return ByteArray(clean.length / 2) { i ->
            clean.substring(i * 2, i * 2 + 2).toInt(16).toByte()
        }
    }
    /**
     * 工具函数：从字节数组切片 BigInteger（32字节）
     */
    fun sliceBigInt32(bytes: ByteArray, offset: Int): BigInteger {
        if (offset + 32 > bytes.size) return BigInteger.ZERO
        val slice = bytes.sliceArray(offset until offset + 32)
        return BigInteger(1, slice)
    }
 }
@@ -0,0 +1,576 @@
 package com.wrbug.polymarketbot.service.copytrading.monitor
 import com.github.benmanes.caffeine.cache.Cache
 import com.github.benmanes.caffeine.cache.Caffeine
 import com.wrbug.polymarketbot.api.TradeResponse
 import com.wrbug.polymarketbot.dto.ActivityTradeMessage
 import com.wrbug.polymarketbot.dto.ActivityTradePayload
 import com.wrbug.polymarketbot.entity.Leader
 import com.wrbug.polymarketbot.repository.LeaderRepository
 import com.wrbug.polymarketbot.service.copytrading.statistics.CopyOrderTrackingService
 import com.wrbug.polymarketbot.util.fromJson
 import com.wrbug.polymarketbot.constants.PolymarketConstants
 import com.wrbug.polymarketbot.websocket.PolymarketWebSocketClient
 import jakarta.annotation.PreDestroy
 import kotlinx.coroutines.*
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
 import java.math.BigDecimal
 import java.util.concurrent.ConcurrentHashMap
 import java.util.concurrent.TimeUnit
 /**
 * Polymarket Activity WebSocket 监听服务
 * 通过订阅全局 activity 交易流（trades + orders_matched），客户端过滤 Leader 地址，实现实时交易检测
 * 延迟 < 100ms，适合快速跟单场景
 */
@Service
 class PolymarketActivityWsService(
    private val copyOrderTrackingService: CopyOrderTrackingService,
    private val leaderRepository: LeaderRepository
 ) {
    private val logger = LoggerFactory.getLogger(PolymarketActivityWsService::class.java)
    private val websocketUrl: String = PolymarketConstants.ACTIVITY_WS_URL
    private val scope = CoroutineScope(Dispatchers.Default + SupervisorJob())
    // 单例 WebSocket 客户端
    private var wsClient: PolymarketWebSocketClient? = null
    // 要监听的 Leader 地址集合（小写地址 -> leaderId）
    private val monitoredAddresses = ConcurrentHashMap<String, Long>()
    // 存储已处理的交易哈希，用于去重（LRU 缓存，保留最近 100 条）
    // 因为同时订阅 trades 和 orders_matched，同一个交易可能被推送两次
    private val processedTxHashes: Cache<String, Long> = Caffeine.newBuilder()
        .maximumSize(100)
        .expireAfterWrite(10, TimeUnit.MINUTES)
        .build()
    // 是否已订阅
    @Volatile
    private var isSubscribed = false
    // 最后一次收到 activity 消息的时间（毫秒时间戳）
    @Volatile
    private var lastActivityTime: Long = 0
    // Activity 消息超时检测任务
    private var activityTimeoutJob: Job? = null
    // 性能统计
    private var totalMessagesProcessed = 0L
    private var addressMatchMessages = 0L
    private var jsonParseMessages = 0L
    private var duplicateTxHashMessages = 0L
    /**
     * 启动监听
     */
    fun start(leaders: List<Leader>) {
        monitoredAddresses.clear()
        leaders.forEach { leader ->
            val leaderId = leader.id
            if (leaderId != null) {
                monitoredAddresses[leader.leaderAddress.lowercase()] = leaderId
            }
        }
        if (monitoredAddresses.isEmpty()) {
            logger.info("没有需要监听的 Leader，停止 Activity WebSocket")
            stop()
            return
        }
        logger.info("启动 Activity WebSocket 监听（trades + orders_matched），监控 ${monitoredAddresses.size} 个 Leader 地址")
        connectAndSubscribe()
    }
    /**
     * 添加 Leader
     */
    fun addLeader(leader: Leader) {
        if (leader.id == null) {
            logger.warn("Leader ID 为空，跳过: ${leader.leaderAddress}")
            return
        }
        val address = leader.leaderAddress.lowercase()
        val existingLeaderId = monitoredAddresses[address]
        if (existingLeaderId != null && existingLeaderId == leader.id) {
            logger.debug("Leader 已在监听列表中: ${leader.leaderName} (${address})")
            return
        }
        val leaderId = leader.id
        if (leaderId != null) {
            monitoredAddresses[address] = leaderId
            logger.info("添加 Leader 到 Activity WS 监听: ${leader.leaderName} (${address})")
            // 如果 WebSocket 未连接，连接
            val client = wsClient
            if (client == null || !client.isConnected()) {
                connectAndSubscribe()
            }
        }
    }
    /**
     * 移除 Leader
     */
    fun removeLeader(leaderId: Long) {
        val addressToRemove = monitoredAddresses.entries
            .find { it.value == leaderId }?.key
        if (addressToRemove != null) {
            monitoredAddresses.remove(addressToRemove)
            logger.info("从 Activity WS 监听移除 Leader: leaderId=$leaderId, address=$addressToRemove")
        }
        // 如果没有 Leader 了，停止监听
        if (monitoredAddresses.isEmpty()) {
            logger.info("没有 Leader 需要监听了，停止 Activity WebSocket")
            stop()
        }
    }
    /**
     * 连接并订阅
     */
    private fun connectAndSubscribe() {
        val existingClient = wsClient
        if (existingClient != null && existingClient.isConnected()) {
            // 如果已连接但未订阅，发送订阅
            if (!isSubscribed) {
                subscribeAllActivity()
            }
            return
        }
        logger.info("连接 Activity WebSocket: $websocketUrl")
        val newClient = PolymarketWebSocketClient(
            url = websocketUrl,
            sessionId = "copy-trading-activity",
            onMessage = { message -> handleMessage(message) },
            onOpen = {
                logger.info("Activity WebSocket 连接成功")
                subscribeAllActivity()
            },
            onReconnect = {
                logger.info("Activity WebSocket 重连成功，重新订阅")
                subscribeAllActivity()
            }
        )
        wsClient = newClient
        scope.launch {
            try {
                newClient.connect()
            } catch (e: Exception) {
                logger.error("连接 Activity WebSocket 失败", e)
            }
        }
    }
    /**
     * 订阅全局 activity
     * 根据 @polymarket/real-time-data-client 的协议格式
     * 使用 "action": "subscribe" 而不是 "type": "subscribe"
     * 同时订阅 trades 和 orders_matched 两种类型
     */
    private fun subscribeAllActivity() {
        val client = wsClient
        if (client == null || !client.isConnected()) {
            logger.warn("WebSocket 未连接，无法订阅")
            return
        }
        try {
            // 根据 real-time-data-client 的协议格式
            // 订阅消息应包含 "action": "subscribe" 和 "subscriptions" 数组
            // 同时订阅 trades 和 orders_matched 两种类型
            val subscribeMessage = """
            {
                "action": "subscribe",
                "subscriptions": [
                    {
                        "topic": "activity",
                        "type": "trades"
                    },
                    {
                        "topic": "activity",
                        "type": "orders_matched"
                    }
                ]
            }
            """.trimIndent()
            client.sendMessage(subscribeMessage)
            isSubscribed = true
            // 重置最后一次收到 activity 消息的时间
            lastActivityTime = System.currentTimeMillis()
            // 启动 Activity 消息超时检测
 //            startActivityTimeoutCheck()
            logger.info("Activity WebSocket 订阅成功（全局交易流: trades + orders_matched）")
        } catch (e: Exception) {
            logger.error("订阅 Activity WebSocket 失败", e)
            isSubscribed = false
        }
    }
    /**
     * 启动 Activity 消息超时检测
     * 每30秒检查一次，如果超过30秒没有收到activity消息，则重连
     */
    private fun startActivityTimeoutCheck() {
        // 先停止之前的检测任务
        stopActivityTimeoutCheck()
        activityTimeoutJob = scope.launch {
            while (isActive && isSubscribed) {
                delay(30000)  // 每30秒检查一次
                // 如果已经取消订阅，停止检测
                if (!isSubscribed) {
                    break
                }
                // 如果 lastActivityTime 为 0，说明还没有收到过消息，跳过本次检测
                if (lastActivityTime == 0L) {
                    continue
                }
                val currentTime = System.currentTimeMillis()
                val timeSinceLastActivity = currentTime - lastActivityTime
                // 如果超过30秒没有收到activity消息，触发重连
                if (timeSinceLastActivity >= 30000) {
                    logger.warn("超过30秒未收到 Activity 消息，触发重连。距离上次消息: ${timeSinceLastActivity}ms")
                    // 关闭当前连接并重连
                    wsClient?.closeConnection()
                    wsClient = null
                    isSubscribed = false
                    // 重新连接
                    connectAndSubscribe()
                    break  // 重连后会重新启动检测任务
                }
            }
        }
    }
    /**
     * 停止 Activity 消息超时检测
     */
    private fun stopActivityTimeoutCheck() {
        activityTimeoutJob?.cancel()
        activityTimeoutJob = null
    }
    /**
     * 检查消息是否包含监听的 Leader 地址
     * 快速过滤，避免不必要的 JSON 解析
     * 只需要检查 "proxyWallet":"0x..." 或 "trader":{"address":"0x..."} 格式
     */
    private fun containsMonitoredAddress(message: String): Boolean {
        // 快速检查：如果消息很短，不可能包含地址
        if (message.length < 50) {
            return false
        }
        // 遍历所有监听的地址
        for ((address, leaderId) in monitoredAddresses) {
            // 检查 proxyWallet：格式为 "proxyWallet":"0x..."
            if (message.contains("\"proxyWallet\":\"$address\"", ignoreCase = true)) {
                addressMatchMessages++
                return true
            }
            // 检查 trader.address：格式为 "trader":{"address":"0x..."}
            if (message.contains("\"trader\"", ignoreCase = true) &&
                message.contains("\"address\":\"$address\"", ignoreCase = true)
            ) {
                addressMatchMessages++
                return true
            }
        }
        return false
    }
    /**
     * 处理消息
     */
    private fun handleMessage(message: String) {
        try {
            totalMessagesProcessed++
            // 处理 PONG 响应
            if (message.trim() == "PONG" || message.trim() == "pong") {
                return
            }
            // 快速预检查：检查是否包含监听地址
            // 绝大部分消息会在这一步被过滤掉，避免不必要的 JSON 解析
            if (!containsMonitoredAddress(message)) {
                return
            }
            logger.info("发现leader交易：${message}")
            // 使用扩展函数解析消息（只对包含监听地址的消息）
            val tradeMessage = message.fromJson<ActivityTradeMessage>() ?: run {
                // 不是有效的 JSON 或格式不匹配，跳过
                logger.warn("无法解析为 ActivityTradeMessage: ${message.take(200)}")
                return
            }
            jsonParseMessages++
            // 检查是否是 activity 消息（trades 或 orders_matched）
            if (tradeMessage.topic != "activity" || 
                (tradeMessage.type != "trades" && tradeMessage.type != "orders_matched")) {
                return
            }
            // 更新最后一次收到 activity 消息的时间（即使不是我们监听的 Leader 的交易）
            lastActivityTime = System.currentTimeMillis()
            val payload = tradeMessage.payload
            // 根据 txHash 去重（使用原子操作避免竞态条件）
            val txHash = payload.transactionHash
            if (txHash != null && txHash.isNotBlank()) {
                val currentTime = System.currentTimeMillis()
                val existingTimestamp = processedTxHashes.asMap().putIfAbsent(txHash, currentTime)
                if (existingTimestamp != null) {
                    duplicateTxHashMessages++
                    logger.debug("交易已处理过，跳过: txHash=$txHash, firstProcessedAt=$existingTimestamp, type=${tradeMessage.type}")
                    return
                }
            }
            // 提取交易者地址
            val traderAddress = extractTraderAddress(payload) ?: run {
                // 没有交易者地址，跳过
                logger.warn("Activity Trade 消息中没有交易者地址: trader=${payload.trader}, proxyWallet=${payload.proxyWallet}, asset=${payload.asset}")
                return
            }
            // 二次验证：确认地址匹配
            val normalizedAddress = traderAddress.lowercase()
            val leaderId = monitoredAddresses[normalizedAddress] ?: run {
                return
            }
            // 解析交易数据
            val trade = parseActivityTrade(payload, leaderId)
            if (trade != null) {
                logger.info("✅ 检测到 Leader 交易: leaderId=$leaderId, address=$traderAddress, side=${trade.side}, market=${trade.market}, size=${trade.size}")
                // 异步处理交易（避免阻塞消息处理）
                scope.launch {
                    try {
                        copyOrderTrackingService.processTrade(
                            leaderId = leaderId,
                            trade = trade,
                            source = "activity-ws"
                        )
                    } catch (e: Exception) {
                        logger.error("处理 Activity WS 交易失败: leaderId=$leaderId, tradeId=${trade.id}", e)
                    }
                }
            } else {
                logger.warn("解析交易数据失败: leaderId=$leaderId, address=$traderAddress, asset=${payload.asset}, side=${payload.side}")
            }
        } catch (e: Exception) {
            logger.error("处理 Activity WebSocket 消息失败: ${e.message}", e)
        }
    }
    /**
     * 提取交易者地址
     * 优先检查 trader.address，fallback 到 proxyWallet
     */
    private fun extractTraderAddress(payload: ActivityTradePayload): String? {
        // 优先检查 trader.address
        val address = payload.trader?.address
            ?: payload.proxyWallet
        return address
    }
    /**
     * 解析 Activity Trade 为 TradeResponse
     */
    private fun parseActivityTrade(payload: ActivityTradePayload, leaderId: Long): TradeResponse? {
        return try {
            // 提取必需字段并验证
            val asset = payload.asset
            val conditionId = payload.conditionId
            val sideRaw = payload.side
            if (asset.isBlank() || conditionId.isBlank() || sideRaw.isBlank()) {
                logger.warn("Activity Trade 消息缺少必需字段: asset=$asset, conditionId=$conditionId, side=$sideRaw")
                return null
            }
            val side = sideRaw.uppercase()
            // 验证 side 必须是 BUY 或 SELL
            if (side != "BUY" && side != "SELL") {
                logger.warn("Activity Trade 消息 side 字段无效: side=$side")
                return null
            }
            // price 和 size 可能是数字或字符串，统一转换为字符串
            val price = convertToString(payload.price) ?: run {
                logger.warn("Activity Trade 消息 price 字段无效: ${payload.price}")
                return null
            }
            val size = convertToString(payload.size) ?: run {
                logger.warn("Activity Trade 消息 size 字段无效: ${payload.size}")
                return null
            }
            // 时间戳处理：可能是秒或毫秒，可能是数字或字符串
            val timestamp = when {
                payload.timestamp == null -> System.currentTimeMillis().toString()
                payload.timestamp is Number -> {
                    val ts = (payload.timestamp as Number).toLong()
                    // 如果时间戳小于 1e12（秒级），转换为毫秒
                    if (ts < 1e12) (ts * 1000).toString() else ts.toString()
                }
                payload.timestamp is String -> {
                    val tsStr = payload.timestamp as String
                    val ts = tsStr.toLongOrNull() ?: System.currentTimeMillis()
                    if (ts < 1e12) (ts * 1000).toString() else tsStr
                }
                else -> System.currentTimeMillis().toString()
            }
            // 解析 outcome 和 outcomeIndex
            // 优先使用消息中的 outcomeIndex，如果没有则从 outcome 字符串解析
            val outcome = payload.outcome
            val outcomeIndex = payload.outcomeIndex
                ?: parseOutcomeIndex(outcome)
            // 使用 transactionHash 作为 trade ID，如果没有则生成 fallback ID
            val tradeId = payload.transactionHash ?: "${leaderId}_${System.currentTimeMillis()}_${asset.take(10)}"
            TradeResponse(
                id = tradeId,
                market = conditionId,
                side = side,
                price = price,
                size = size,
                timestamp = timestamp,
                user = null, // Activity WS 中不需要
                outcomeIndex = outcomeIndex,
                outcome = outcome
            )
        } catch (e: Exception) {
            logger.error("解析 Activity Trade 失败: ${e.message}", e)
            null
        }
    }
    /**
     * 将 Any 类型的值转换为 String
     * 支持 Number、String、BigDecimal 等类型
     */
    private fun convertToString(value: Any?): String? {
        if (value == null) return null
        return when (value) {
            is String -> value
            is Number -> {
                // 如果是数字，转换为 BigDecimal 再转为字符串（保持精度）
                try {
                    BigDecimal(value.toString()).toPlainString()
                } catch (e: Exception) {
                    value.toString()
                }
            }
            is BigDecimal -> value.toPlainString()
            else -> value.toString()
        }
    }
    /**
     * 解析 outcome 为 outcomeIndex
     */
    private fun parseOutcomeIndex(outcome: String?): Int? {
        return when (outcome?.uppercase()) {
            "YES", "UP", "TRUE" -> 0
            "NO", "DOWN", "FALSE" -> 1
            else -> null
        }
    }
    /**
     * 停止监听
     */
    fun stop() {
        logger.info("停止 Activity WebSocket 监听")
        stopActivityTimeoutCheck()
        wsClient?.closeConnection()
        wsClient = null
        isSubscribed = false
        monitoredAddresses.clear()
        processedTxHashes.invalidateAll()  // 清空去重缓存
        lastActivityTime = 0
    }
    /**
     * 获取连接状态
     */
    fun isConnected(): Boolean {
        return wsClient?.isConnected() ?: false
    }
    /**
     * 获取监听的 Leader 数量
     */
    fun getMonitoredCount(): Int {
        return monitoredAddresses.size
    }
    /**
     * 获取性能统计信息
     */
    fun getPerformanceStats(): Map<String, Any> {
        val jsonParseRate = if (totalMessagesProcessed > 0) {
            (jsonParseMessages.toDouble() / totalMessagesProcessed * 100).toInt()
        } else {
            0
        }
        return mapOf(
            "totalMessages" to totalMessagesProcessed,
            "addressMatches" to addressMatchMessages,
            "jsonParses" to jsonParseMessages,
            "duplicateTxHashes" to duplicateTxHashMessages,
            "jsonParseRate" to "$jsonParseRate%",
            "filteringEfficiency" to if (totalMessagesProcessed > 0) {
                ((1.0 - jsonParseMessages.toDouble() / totalMessagesProcessed) * 100).toInt()
            } else {
                0
            }
        )
    }
    @PreDestroy
    fun destroy() {
        logger.info("Activity WS 性能统计: ${getPerformanceStats()}")
        stop()
        scope.cancel()
    }
 }
@@ -0,0 +1,446 @@
 package com.wrbug.polymarketbot.service.copytrading.monitor
 import com.google.gson.Gson
 import com.google.gson.JsonArray
 import com.google.gson.JsonObject
 import com.wrbug.polymarketbot.api.*
 import com.wrbug.polymarketbot.service.system.RpcNodeService
 import com.wrbug.polymarketbot.util.RetrofitFactory
 import com.wrbug.polymarketbot.util.createClient
 import com.wrbug.polymarketbot.util.getProxyConfig
 import jakarta.annotation.PostConstruct
 import jakarta.annotation.PreDestroy
 import kotlinx.coroutines.*
 import okhttp3.OkHttpClient
 import okhttp3.Request
 import okhttp3.WebSocket
 import okhttp3.WebSocketListener
 import okio.ByteString
 import org.slf4j.LoggerFactory
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.stereotype.Service
 import java.util.concurrent.ConcurrentHashMap
 import java.util.concurrent.atomic.AtomicInteger
 /**
 * 统一的链上 WebSocket 服务
 * 管理唯一的 WebSocket 连接，其他服务通过订阅的方式接收链上事件
 */
@Service
 class UnifiedOnChainWsService(
    private val rpcNodeService: RpcNodeService,
    private val retrofitFactory: RetrofitFactory,
    private val gson: Gson
 ) {
    private val logger = LoggerFactory.getLogger(UnifiedOnChainWsService::class.java)
    @Value("\${copy.trading.onchain.ws.reconnect.delay:3000}")
    private var reconnectDelay: Long = 3000  // 重连延迟（毫秒），默认3秒
    private val scope = CoroutineScope(Dispatchers.Default + SupervisorJob())
    // 存储所有地址的连接：address -> AddressWsConnection
    private val addressConnections = ConcurrentHashMap<String, AddressWsConnection>()
    /**
     * 订阅信息
     */
    data class SubscriptionInfo(
        val subscriptionId: String,  // 订阅的唯一标识
        val address: String,  // 要监听的地址（Leader 地址或账户代理地址）
        val entityType: String,  // 实体类型：LEADER 或 ACCOUNT
        val entityId: Long,  // 实体 ID（Leader ID 或 Account ID）
        val callback: suspend (String, OkHttpClient, EthereumRpcApi) -> Unit  // 回调函数
    )
    /**
     * 订阅地址监听
     * @param subscriptionId 订阅的唯一标识（建议格式："{entityType}_{entityId}"）
     * @param address 要监听的地址（Leader 地址或账户代理地址）
     * @param entityType 实体类型：LEADER 或 ACCOUNT
     * @param entityId 实体 ID（Leader ID 或 Account ID）
     * @param callback 回调函数，当检测到该地址的交易时调用
     * @return 是否订阅成功
     */
    fun subscribe(
        subscriptionId: String,
        address: String,
        entityType: String,
        entityId: Long,
        callback: suspend (String, OkHttpClient, EthereumRpcApi) -> Unit
    ): Boolean {
        try {
            val lowerAddress = address.lowercase()
            // 找到或创建该地址的连接
            val connection = addressConnections.computeIfAbsent(lowerAddress) {
                AddressWsConnection(it).apply { start() }
            }
            // 创建订阅信息
            val subscription = SubscriptionInfo(
                subscriptionId = subscriptionId,
                address = lowerAddress,
                entityType = entityType,
                entityId = entityId,
                callback = callback
            )
            // 添加订阅
            connection.addSubscription(subscription)
            logger.info("订阅地址监听: subscriptionId=$subscriptionId, address=$address, entityType=$entityType, entityId=$entityId")
            return true
        } catch (e: Exception) {
            logger.error("订阅地址监听失败: subscriptionId=$subscriptionId, address=$address, error=${e.message}", e)
            return false
        }
    }
    /**
     * 取消订阅
     */
    fun unsubscribe(subscriptionId: String) {
        // 遍历所有连接找到含有该订阅的连接
        for (connection in addressConnections.values) {
            if (connection.hasSubscription(subscriptionId)) {
                connection.removeSubscription(subscriptionId)
                // 如果该连接没有订阅了，停止并移除
                if (connection.isSubscriptionsEmpty()) {
                    connection.stop()
                    addressConnections.remove(connection.address)
                    logger.info("连接已无订阅，关闭连接: address=${connection.address}")
                }
                logger.info("取消订阅: subscriptionId=$subscriptionId")
                return
            }
        }
    }
    /**
     * 停止所有服务
     */
    fun stop() {
        for (connection in addressConnections.values) {
            connection.stop()
        }
        addressConnections.clear()
    }
    /**
     * 获取连接状态
     * @return Map<address, isConnected>
     */
    fun getConnectionStatuses(): Map<String, Boolean> {
        return addressConnections.mapValues { (_, connection) -> connection.isConnected() }
    }
    @PostConstruct
    fun init() {
        logger.info("统一链上 WebSocket 服务已初始化 (独立连接模式)")
    }
    @PreDestroy
    fun destroy() {
        stop()
        scope.cancel()
    }
    /**
     * 单个地址的 WebSocket 连接管理
     */
    inner class AddressWsConnection(val address: String) {
        private var webSocket: WebSocket? = null
        @Volatile
        private var isConnected = false
        // 订阅ID计数器（用于请求 ID）
        private var requestIdCounter = AtomicInteger(0)
        // 连接任务
        private var connectionJob: Job? = null
        // 该连接下的所有订阅：subscriptionId -> SubscriptionInfo
        // 理论上一个地址可能被多个业务订阅（如：既是被跟单者又是普通监控），虽然业务上通常只有一个
        private val subscriptions = ConcurrentHashMap<String, SubscriptionInfo>()
        // 存储请求 ID 到订阅 ID 的映射：requestId -> subscriptionId
        private val requestIdToSubscriptionId = ConcurrentHashMap<Int, String>()
        // 存储 RPC subscriptionId 到订阅 ID 的映射：rpcSubscriptionId -> subscriptionId
        private val rpcSubscriptionIdToSubscriptionId = ConcurrentHashMap<String, String>()
        fun start() {
            if (connectionJob != null && connectionJob!!.isActive) return
            connectionJob = scope.launch {
                startConnectionLoop()
            }
        }
        fun stop() {
            connectionJob?.cancel()
            connectionJob = null
            webSocket?.close(1000, "停止监听")
            webSocket = null
            isConnected = false
            subscriptions.clear()
            requestIdToSubscriptionId.clear()
            rpcSubscriptionIdToSubscriptionId.clear()
        }
        fun addSubscription(subscription: SubscriptionInfo) {
            // 如果已经存在，先移除旧的
            removeSubscription(subscription.subscriptionId)
            subscriptions[subscription.subscriptionId] = subscription
            // 如果已经连接，立即发送链上订阅请求
            if (isConnected) {
                scope.launch {
                    subscribeAddressOnChain(subscription)
                }
            }
        }
        fun removeSubscription(subscriptionId: String) {
            subscriptions.remove(subscriptionId)
            // 不需要显式发送 eth_unsubscribe，因为连接是 per-address 的，
            // 只要只要连接还在，就保持该地址相关的所有 logs 订阅。
            // 只有当所有 subscription 都移除了，连接才会关闭。
        }
        fun hasSubscription(subscriptionId: String): Boolean {
            return subscriptions.containsKey(subscriptionId)
        }
        fun isSubscriptionsEmpty(): Boolean {
            return subscriptions.isEmpty()
        }
        fun isConnected(): Boolean {
            return isConnected
        }
        private suspend fun startConnectionLoop() {
            while (scope.isActive) {
                try {
                    if (subscriptions.isEmpty()) {
                        // 如果启动循环时还没订阅（不太可能，通常是先 addSubscription 再 start，或者是 start 后 addSubscription）
                        // 或者订阅被清空了，外部应当掉 stop，但这里作为防守
                        delay(1000) 
                        continue
                    }
                    if (isConnected && webSocket != null) {
                        waitForDisconnect()
                        continue
                    }
                    // 获取可用的 RPC 节点
                    val wsUrl = rpcNodeService.getWsUrl()
                    val httpUrl = rpcNodeService.getHttpUrl()
                    logger.info("[$address] 连接链上 WebSocket: $wsUrl")
                    val httpClient = createHttpClient()
                    val rpcApi = retrofitFactory.createEthereumRpcApi(httpUrl)
                    connectWebSocket(wsUrl, httpClient, rpcApi)
                    waitForConnect()
                    if (isConnected) {
                        logger.info("[$address] WebSocket 连接已建立，开始注册订阅")
                        // 重新为所有订阅注册链上监听
                        for (subscription in subscriptions.values) {
                            subscribeAddressOnChain(subscription)
                        }
                        waitForDisconnect()
                    }
                    logger.info("[$address] WebSocket 连接断开，等待 ${reconnectDelay}ms 后重连")
                    delay(reconnectDelay)
                } catch (e: Exception) {
                    logger.error("[$address] 连接异常: ${e.message}", e)
                    delay(reconnectDelay)
                }
            }
        }
        private fun connectWebSocket(wsUrl: String, httpClient: OkHttpClient, rpcApi: EthereumRpcApi) {
            webSocket?.close(1000, "重新连接")
            webSocket = null
            isConnected = false
            val request = Request.Builder().url(wsUrl).build()
            webSocket = httpClient.newWebSocket(request, object : WebSocketListener() {
                override fun onOpen(webSocket: WebSocket, response: okhttp3.Response) {
                    isConnected = true
                    logger.info("[$address] 链上 WebSocket 连接成功")
                }
                override fun onMessage(webSocket: WebSocket, text: String) {
                    scope.launch { handleMessage(text, httpClient, rpcApi) }
                }
                override fun onMessage(webSocket: WebSocket, bytes: ByteString) {
                    scope.launch { handleMessage(bytes.utf8(), httpClient, rpcApi) }
                }
                override fun onClosing(webSocket: WebSocket, code: Int, reason: String) {
                    isConnected = false
                    logger.warn("[$address] 链上 WebSocket 连接关闭: code=$code, reason=$reason")
                }
                override fun onClosed(webSocket: WebSocket, code: Int, reason: String) {
                    isConnected = false
                    logger.warn("[$address] 链上 WebSocket 连接已关闭: code=$code, reason=$reason")
                }
                override fun onFailure(webSocket: WebSocket, t: Throwable, response: okhttp3.Response?) {
                    logger.error("[$address] 链上 WebSocket 连接失败: ${t.message}", t)
                    isConnected = false
                }
            })
        }
        private suspend fun subscribeAddressOnChain(subscription: SubscriptionInfo) {
            if (webSocket == null || !isConnected) return
            val walletTopic = OnChainWsUtils.addressToTopic32(address)
            val subId = subscription.subscriptionId
            try {
                // 订阅该地址相关的所有事件
                // USDC Transfer (from/to)
                subscribeLogs(OnChainWsUtils.USDC_CONTRACT, listOf(OnChainWsUtils.ERC20_TRANSFER_TOPIC, walletTopic), subId)
                subscribeLogs(OnChainWsUtils.USDC_CONTRACT, listOf(OnChainWsUtils.ERC20_TRANSFER_TOPIC, null, walletTopic), subId)
                // ERC1155 TransferSingle (from/to)
                subscribeLogs(OnChainWsUtils.ERC1155_CONTRACT, listOf(OnChainWsUtils.ERC1155_TRANSFER_SINGLE_TOPIC, null, walletTopic), subId)
                subscribeLogs(OnChainWsUtils.ERC1155_CONTRACT, listOf(OnChainWsUtils.ERC1155_TRANSFER_SINGLE_TOPIC, null, null, walletTopic), subId)
                // ERC1155 TransferBatch (from/to)
                subscribeLogs(OnChainWsUtils.ERC1155_CONTRACT, listOf(OnChainWsUtils.ERC1155_TRANSFER_BATCH_TOPIC, null, walletTopic), subId)
                subscribeLogs(OnChainWsUtils.ERC1155_CONTRACT, listOf(OnChainWsUtils.ERC1155_TRANSFER_BATCH_TOPIC, null, null, walletTopic), subId)
                logger.debug("[$address] 已发送链上订阅请求: subscriptionId=$subId")
            } catch (e: Exception) {
                logger.error("[$address] 发送链上订阅请求失败: error=${e.message}", e)
            }
        }
        private fun subscribeLogs(contractAddress: String, topics: List<String?>, subscriptionId: String) {
            val ws = webSocket ?: return
            val topicsArray = gson.toJsonTree(topics).asJsonArray
            val logParams = JsonObject()
            logParams.addProperty("address", contractAddress.lowercase())
            logParams.add("topics", topicsArray)
            val requestId = requestIdCounter.incrementAndGet()
            requestIdToSubscriptionId[requestId] = subscriptionId
            val request = JsonObject()
            request.addProperty("jsonrpc", "2.0")
            request.addProperty("id", requestId)
            request.addProperty("method", "eth_subscribe")
            val paramsArray = JsonArray()
            paramsArray.add("logs")
            paramsArray.add(logParams)
            request.add("params", paramsArray)
            ws.send(gson.toJson(request))
        }
        private suspend fun handleMessage(text: String, httpClient: OkHttpClient, rpcApi: EthereumRpcApi) {
            try {
                val message = gson.fromJson(text, JsonObject::class.java)
                // 1. 处理订阅响应 (eth_subscribe response)
                if (message.has("result") && message.has("id")) {
                    val requestId = message.get("id")?.asInt
                    val rpcSubscriptionId = message.get("result")?.asString
                    if (requestId != null && rpcSubscriptionId != null) {
                        val subId = requestIdToSubscriptionId.remove(requestId)
                        if (subId != null) {
                            rpcSubscriptionIdToSubscriptionId[rpcSubscriptionId] = subId
                            logger.debug("[$address] 链上订阅成功: mapped connection rpcSubId=$rpcSubscriptionId to localSubId=$subId")
                        }
                    }
                    return
                }
                // 2. 处理日志通知 (eth_subscription)
                val method = message.get("method")?.asString
                if (method == "eth_subscription") {
                    val params = message.getAsJsonObject("params") ?: return
                    val rpcSubParam = params.get("subscription")?.asString
                    val result = params.getAsJsonObject("result") ?: return
                    val txHash = result.get("transactionHash")?.asString
                    if (txHash != null && rpcSubParam != null) {
                        // 找到触发此通知的本地订阅 ID
                        // 因为我们在这个连接里只订阅了 this.address，所以理论上所有通知都跟这个 address 有关
                        // 但我们需要找到对应的 callback
                        val localSubId = rpcSubscriptionIdToSubscriptionId[rpcSubParam]
                        if (localSubId != null) {
                            val subscription = subscriptions[localSubId]
                            if (subscription != null) {
                                logger.info("[$address] 收到交易通知: txHash=$txHash, subId=$localSubId")
                                runCatching {
                                    subscription.callback(txHash, httpClient, rpcApi)
                                }.onFailure { e ->
                                    logger.error("[$address] 回调执行失败: ${e.message}", e)
                                }
                            }
                        } else {
                            // 找不到具体是哪个订阅请求触发的（可能是重启后之前的订阅残留？或者映射丢失？）
                            // 在单地址单连接模式下，只要是这个 connection 收到的，肯定是关于这个 address 的
                            // 我们可以尝试通知所有订阅者（通常一个地址只有一个订阅者，除非此地址既是Leader又是User）
                            logger.warn("[$address] 未找到映射的订阅ID: rpcSubId=$rpcSubParam. 广播给所有订阅者.")
                            subscriptions.values.forEach { sub ->
                                runCatching {
                                    sub.callback(txHash, httpClient, rpcApi)
                                }.onFailure { e ->
                                    logger.error("[$address] 广播回调执行失败: ${e.message}", e)
                                }
                            }
                        }
                    }
                }
            } catch (e: Exception) {
                logger.error("[$address] 处理消息失败: ${e.message}", e)
            }
        }
        private suspend fun waitForConnect() {
            var waited = 0L
            val timeout = 15000L
            while (!isConnected && waited < timeout) {
                delay(100)
                waited += 100
            }
            if (!isConnected) logger.warn("[$address] WebSocket 连接超时")
        }
        private suspend fun waitForDisconnect() {
            while (isConnected && scope.isActive) {
                delay(1000)
            }
        }
        private fun createHttpClient(): OkHttpClient {
            val proxy = getProxyConfig()
            val builder = createClient()
            if (proxy != null) builder.proxy(proxy)
            return builder.build()
        }
    }
 }
--- a/Show More
+++ b/Show More