gavindiaz/PolyHermes
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
dynamic_load
PolyHermes/RELEASE.md
T
WrBug f6fc836e79 docs: 添加 v1.1.10 release notes
2026-01-12 14:51:33 +08:00

38 KiB
Raw Permalink Blame History

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（如果这是最新版本）

🔗 相关链接

发布日期：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（如果这是最新版本）

🔗 相关链接

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 解析

  • 参考文档：

🔧 支持同一用户创建多个相同 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（如果这是最新版本）

🔗 相关链接

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）

合约调用修复

📝 升级说明

数据库升级

  • 无需数据库迁移：本次更新不涉及数据库结构变更

配置更新

  • 可选配置：新增日志级别环境变量，如不配置将使用默认值
    • LOG_LEVEL_ROOT=INFO（默认）
    • LOG_LEVEL_APP=DEBUG（默认）

Docker 部署

  • 推荐更新：使用 Docker Hub 镜像部署的用户，建议更新到最新版本 
    docker pull wrbug/polyhermes:latest
docker-compose -f docker-compose.prod.yml up -d

🔗 相关链接

发布日期：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. 代码清理：移除不再使用的刷新代理钱包接口

🔗 相关链接

🙏 致谢

感谢所有贡献者和测试用户的反馈与支持！

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）

🔗 相关链接

📊 统计信息

  • 文件变更: 29 个文件
  • 代码变更: +1597 行 / -678 行
  • 主要提交: 8 个提交

⚠️ 重要提醒

请务必使用官方 Docker 镜像源，避免财产损失！

✅ 官方 Docker Hub 镜像

官方镜像地址：wrbug/polyhermes

# ✅ 正确：使用官方镜像
docker pull wrbug/polyhermes:v1.1.2

# ❌ 错误：不要使用其他来源的镜像
# 任何非官方来源的镜像都可能包含恶意代码，导致您的私钥和资产被盗

🔗 官方渠道

请通过以下唯一官方渠道获取 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）

🔗 相关链接

📊 统计信息

  • 文件变更: 32 个文件
  • 代码变更: +1872 行 / -1503 行
  • 主要提交: 7 个提交

⚠️ 重要提醒

请务必使用官方 Docker 镜像源，避免财产损失！

✅ 官方 Docker Hub 镜像

官方镜像地址：wrbug/polyhermes

# ✅ 正确：使用官方镜像
docker pull wrbug/polyhermes:v1.1.1

# ❌ 错误：不要使用其他来源的镜像
# 任何非官方来源的镜像都可能包含恶意代码，导致您的私钥和资产被盗

🔗 官方渠道

请通过以下唯一官方渠道获取 PolyHermes：

⭐ 如果这个项目对您有帮助，请给个 Star 支持一下！

Reference in New Issue View Git Blame Copy Permalink