# 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 支持一下！**