gavindiaz/PolyHermes
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 清理根目录临时文档

Browse Source 
- 删除过时的版本发布说明（RELEASE.md 和 RELEASE_NOTES_v2.0.*.md）
- 删除临时检查报告（CHECK_AND_FIX_REPORT.md、IMPLEMENTATION_COMPLETE.md、MISSING_ITEMS_CHECK.md）
- 所有版本发布信息统一在 RELEASE_NOTES.md 中管理
- 添加新的部署指南文档和 Docker 构建配置

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
WrBug
2026-02-08 23:34:46 +08:00
parent b616e10ceb
commit 01a1836659
10 changed files with 339 additions and 2076 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CHECK_AND_FIX_REPORT.md
-37
View File
@@ -1,37 +0,0 @@
# 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 测试。
---
**状态**: ✅ **全功能就绪，已加固**
IMPLEMENTATION_COMPLETE.md
-301
View File
@@ -1,301 +0,0 @@
# 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 进行测试验证
MISSING_ITEMS_CHECK.md
-31
View File
@@ -1,31 +0,0 @@
# 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）...
RELEASE.md
-971
View File
@@ -1,971 +0,0 @@
# 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 支持一下！**
RELEASE_NOTES_v2.0.0.md
-177
View File
@@ -1,177 +0,0 @@
# 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)
RELEASE_NOTES_v2.0.1.md
-173
View File
@@ -1,173 +0,0 @@
# PolyHermes v2.0.1 Release Notes
## 📋 版本信息
- **版本号**: v2.0.1
- **发布日期**: 2026-01-28
- **基础版本**: v2.0.0
## 🎯 改动摘要
本次版本主要修复了订单状态检查、RPC 节点管理、订单金额计算等关键问题，提升了系统稳定性和用户体验。
---
## 🐛 Bug 修复
### 1. 修复订单状态检查中缓存清除导致计时重置的问题
**问题描述**：
- 订单详情为 `null` 时，缓存清除时机不当导致计时被重置
- 订单超过 60 秒后无法正常删除
- 部分卖出订单等待时间过长（之前等待 1 小时）
**修复内容**：
- ✅ 修复缓存清除时机问题，避免计时被重置
- ✅ 统一部分卖出和未成交订单的删除逻辑，都使用 60 秒重试窗口
- ✅ 删除未使用的常量 `PARTIAL_SOLD_CLEANUP_WINDOW_MS`
- ✅ 优化日志输出，区分部分卖出和未成交订单的日志信息
**影响范围**：
- `OrderStatusUpdateService.kt` - 订单状态更新服务
**提交**: 7e87965
---
### 2. 修复禁用 RPC 节点后仍被使用的问题
**问题描述**：
- 禁用 RPC 节点后，节点仍可能被系统使用
- 节点状态更新不及时
**修复内容**：
- ✅ 修复节点禁用逻辑，确保禁用后立即生效
- ✅ 优化节点状态检查机制
- ✅ 改进节点选择逻辑
**影响范围**：
- `RpcNodeService.kt` - RPC 节点服务
**提交**: dd39e59
---
### 3. 修复订单金额计算和价格范围验证问题
**问题描述**：
- 订单金额计算可能存在精度问题
- 价格范围验证逻辑不完善
**修复内容**：
- ✅ 修复订单金额计算逻辑
- ✅ 完善价格范围验证
- ✅ 优化数值计算精度处理
**影响范围**：
- `OrderSigningService.kt` - 订单签名服务
**提交**: 2b20f4b
---
### 4. 修复系统更新 API 路由和改进健康检查逻辑
**问题描述**：
- 系统更新 API 路由可能存在问题
- 健康检查逻辑需要优化
**修复内容**：
- ✅ 修复系统更新 API 路由
- ✅ 改进健康检查逻辑
- ✅ 优化错误处理
**提交**: 4aa85a9
---
### 5. 修复 Docker 构建相关问题
**问题描述**：
- 本地 Docker 构建时 `frontend/dist` 和 `backend/build` 不存在导致构建失败
- Dockerfile 中前端产物复制逻辑有问题
**修复内容**：
- ✅ 修复本地 Docker 构建时目录不存在的问题
- ✅ 修复 Dockerfile 中前端产物复制逻辑
- ✅ 优化构建流程
**影响范围**：
- `Dockerfile` - Docker 构建文件
- `deploy.sh` - 部署脚本
**提交**: 419c68c, 8889803
---
### 6. 补充缺失的多语言 key
**问题描述**：
- 部分多语言 key 缺失，导致界面显示异常
**修复内容**：
- ✅ 补充缺失的多语言 key
- ✅ 完善多语言支持
**影响范围**：
- `frontend/src/locales/` - 多语言文件
**提交**: 2efc04a
---
## 🔧 优化改进
### 优化过滤原因文案的数值显示格式
**改进内容**：
- ✅ 优化过滤原因文案的数值显示格式
- ✅ 新增日期工具函数，统一日期格式化
- ✅ 提升用户体验
**影响范围**：
- `CopyTradingFilterService.kt` - 跟单过滤服务
- `DateUtils.kt` - 日期工具类（新增）
**提交**: e115d45
---
## 📊 文件变更统计
- **修改文件数**: 10+
- **新增文件数**: 1 (DateUtils.kt)
- **新增行数**: 200+
- **删除行数**: 100+
---
## 🔄 升级建议
1. **直接部署**：无需特殊操作，直接部署即可
2. **验证订单处理**：建议验证订单状态检查是否正常工作
3. **检查 RPC 节点**：确认 RPC 节点状态管理是否正常
4. **验证订单金额**：确认订单金额计算是否正确
---
## 📝 完整提交列表
- 7e87965 - fix: 修复订单状态检查中缓存清除导致计时重置的问题
- e115d45 - refactor: 优化过滤原因文案的数值显示格式
- dd39e59 - fix: 修复禁用RPC节点后仍被使用的问题
- 2efc04a - fix: 补充缺失的多语言key
- 2b20f4b - fix: 修复订单金额计算和价格范围验证问题
- 419c68c - fix: 修复本地 Docker 构建时 frontend/dist 和 backend/build 不存在的问题
- 8889803 - fix: 修复 Dockerfile 中前端产物复制逻辑
- 4aa85a9 - fix: 修复系统更新 API 路由和改进健康检查逻辑
---
## 🙏 致谢
感谢所有贡献者和用户的支持与反馈！
RELEASE_NOTES_v2.0.2.md
-144
View File
@@ -1,144 +0,0 @@
# PolyHermes v2.0.2 Release Notes
## 📋 版本信息
- **版本号**: v2.0.2
- **发布日期**: 2026-01-29
- **基础版本**: v2.0.1
## 🎯 改动摘要
本次版本主要修复了买入订单金额精度问题，并优化了构建流程和通知机制。
---
## 🐛 Bug 修复
### 1. 修复买入订单金额精度问题
**问题描述**：
- 市场买入订单创建时出现 `invalid amounts` 错误
- Polymarket API 要求市场买入订单的 makerAmount 最多 2 位小数，takerAmount 最多 4 位小数
- 之前的实现不符合 API 要求，导致订单创建失败
**修复内容**：
- ✅ 修复市场买入订单 makerAmount 和 takerAmount 的精度限制
- ✅ makerAmount (USDC) 限制为最多 2 位小数（之前为 4 位）
- ✅ takerAmount (shares) 限制为最多 4 位小数（之前为 2 位）
- ✅ 符合 Polymarket API 的要求，解决 'invalid amounts' 错误
**影响范围**：
- `OrderSigningService.kt` - 订单签名服务
**提交**: 42472f6
---
## 🔧 优化改进
### 优化构建流程和通知机制
**改进内容**：
- ✅ 添加 workflow_dispatch 支持手动触发构建
- ✅ Release 事件默认只打包产物（在线升级），不构建 Docker
- ✅ 手动触发可选择构建类型：在线升级或 Docker 升级
- ✅ 优化 Telegram 通知文案，区分构建类型和升级路径
- ✅ 在线升级任务不发送开始通知，只发送完成通知
- ✅ 手动触发时产物上传为 Artifact，Release 事件上传到 Release Assets
**影响范围**：
- `.github/workflows/docker-build.yml` - GitHub Actions 工作流
**提交**: e5992b5
---
## ⚠️ 潜在问题和注意事项
### 1. 买入订单金额精度调整可能带来的影响
**问题说明**：
本次修复调整了买入订单的金额精度限制，可能会带来以下影响：
#### 1.1 makerAmount 精度降低（4 位 → 2 位小数）
**影响**：
- **订单金额可能被向下舍入**：由于 makerAmount (USDC) 从 4 位小数降低到 2 位小数，订单金额可能会被向下舍入
- **实际支付金额可能略低于预期**：例如，如果计算出的金额是 `0.5985 USDC`，现在会被舍入为 `0.59 USDC`，实际支付金额可能比预期少 `0.0085 USDC`
- **可能影响固定金额模式的跟单**：在固定金额模式下，如果金额被舍入，实际买入的数量可能会略少于预期
**建议**：
- 在固定金额模式下，建议设置稍大一点的金额，以补偿可能的舍入损失
- 监控订单创建情况，确认金额是否符合预期
- 如果发现金额差异较大，可以适当调整跟单配置
#### 1.2 takerAmount 精度提高（2 位 → 4 位小数）
**影响**：
- **订单数量精度提高**：takerAmount (shares) 从 2 位小数提高到 4 位小数，可以更精确地指定买入数量
- **可能增加订单复杂度**：更高的精度可能导致一些边缘情况，需要确保数量计算正确
**建议**：
- 验证订单数量是否符合预期
- 确认跟单数量计算逻辑是否正确
#### 1.3 订单创建成功率变化
**影响**：
- **修复前**：订单创建可能因为精度问题失败
- **修复后**：订单创建成功率应该提高，但金额可能略有变化
**建议**：
- 升级后监控订单创建成功率
- 对比升级前后的订单金额，确认差异是否在可接受范围内
### 2. 构建流程变更
**影响**：
- Release 事件默认只打包产物，不构建 Docker
- 如果需要 Docker 镜像，需要手动触发构建并选择 Docker 升级类型
**建议**：
- 了解新的构建流程，根据需要选择合适的构建方式
- 如果需要 Docker 镜像，使用 workflow_dispatch 手动触发
---
## 📊 文件变更统计
- **修改文件数**: 2
- **新增行数**: 127
- **删除行数**: 27
---
## 🔄 升级建议
1. **测试买入订单创建**：
- 升级后先测试少量买入订单，确认金额和数量是否符合预期
- 特别关注固定金额模式的跟单，确认金额是否被正确舍入
2. **监控订单创建成功率**：
- 升级后监控订单创建成功率，确认是否解决了 `invalid amounts` 错误
- 对比升级前后的订单金额，确认差异是否在可接受范围内
3. **验证金额计算**：
- 验证 makerAmount 是否被正确限制为 2 位小数
- 验证 takerAmount 是否被正确限制为 4 位小数
4. **了解构建流程变更**：
- 了解新的构建流程，根据需要选择合适的构建方式
- 如果需要 Docker 镜像，使用 workflow_dispatch 手动触发
---
## 📝 完整提交列表
- 42472f6 - fix: 修复买入订单金额精度问题
- e5992b5 - feat(workflow): 优化构建流程和通知机制
---
## 🙏 致谢
感谢所有贡献者和用户的支持与反馈！
RELEASE_NOTES_v2.0.3.md
-241
View File
@@ -1,241 +0,0 @@
# PolyHermes v2.0.3 Release Notes
## 📋 版本信息
- **版本号**: v2.0.3
- **发布日期**: 2026-01-31
- **基础版本**: v2.0.2
## 🎯 改动摘要
本次版本主要优化了用户界面显示，包括数值格式化、Leader列表优化、移除不必要的配置项，提升了用户体验。
---
## ✨ 新功能
### 1. 为所有数值显示添加千分位分隔符
**功能描述**：
- ✅ 重构 `formatNumber` 和 `formatUSDC` 函数，默认添加千分位分隔符
- ✅ 所有数值（金额、数量、价格等）现在默认显示千分位
- ✅ 自动去除尾随零，提升可读性
- ✅ 示例：`1234567.89` 显示为 `1,234,567.89`
**影响范围**：
- `frontend/src/utils/index.ts` - 工具函数
- `frontend/src/pages/Statistics.tsx` - 统计页面
- `frontend/src/pages/CopyTradingStatistics.tsx` - 跟单统计页面
- `frontend/src/pages/PositionList.tsx` - 持仓列表
- `frontend/src/pages/AccountList.tsx` - 账户列表
**提交**: 40081c2
---
### 2. 在创建跟单配置时显示Leader资产信息
**功能描述**：
- ✅ 选择Leader后自动获取并显示资产信息
- ✅ 显示总资产、可用余额、仓位资产
- ✅ 使用Card和Statistic组件美观展示
- ✅ 支持中英文多语言
- ✅ 使用formatUSDC格式化显示金额
**影响范围**：
- `frontend/src/pages/CopyTradingOrders/AddModal.tsx` - 添加跟单配置弹窗
- `frontend/src/pages/CopyTradingOrders/EditModal.tsx` - 编辑跟单配置弹窗
- `frontend/src/locales/**/common.json` - 多语言文件
**提交**: 390b3ee
---
### 3. Leader列表显示仓位资产
**功能描述**：
- ✅ Leader列表新增仓位资产显示
- ✅ 显示Leader的总资产、可用余额、仓位资产
- ✅ 优化资产信息展示方式
**影响范围**：
- `frontend/src/pages/LeaderList.tsx` - Leader列表页面
- `backend/src/main/kotlin/com/wrbug/polymarketbot/dto/LeaderDto.kt` - Leader DTO
- `backend/src/main/kotlin/com/wrbug/polymarketbot/service/copytrading/leaders/LeaderService.kt` - Leader服务
**提交**: 3350039
---
## 🔧 优化改进
### 1. Leader列表优化
**改进内容**：
- ✅ 后端过滤价值为0的仓位
- ✅ 持仓列表显示市场名称而非ID
- ✅ 列表移除分类和创建时间列
- ✅ 文案'跟单关系数'改为'跟单数'
- ✅ 持仓DTO添加title字段
**影响范围**：
- `frontend/src/pages/LeaderList.tsx` - Leader列表页面
- `backend/src/main/kotlin/com/wrbug/polymarketbot/service/copytrading/leaders/LeaderService.kt` - Leader服务
- `backend/src/main/kotlin/com/wrbug/polymarketbot/service/common/BlockchainService.kt` - 区块链服务
**提交**: 0bdc0c7
---
### 2. 列表只显示可用余额
**改进内容**：
- ✅ 账户列表和Leader列表只显示可用余额
- ✅ 简化界面，减少信息冗余
**影响范围**：
- `frontend/src/pages/AccountList.tsx` - 账户列表
- `backend/src/main/kotlin/com/wrbug/polymarketbot/service/accounts/AccountService.kt` - 账户服务
**提交**: 17eea01
---
### 3. 移除仓位资产列
**改进内容**：
- ✅ 移除不必要的仓位资产列显示
- ✅ 简化界面布局
**影响范围**：
- `frontend/src/pages/PositionList.tsx` - 持仓列表
**提交**: 6980781
---
## 🗑️ 移除功能
### 移除跟单最大仓位数量(maxPositionCount)配置
**移除原因**：
- 该配置项使用频率低，且增加了系统复杂度
- 简化跟单配置，提升用户体验
**移除内容**：
- ✅ 数据库：创建迁移文件 V26 删除 `max_position_count` 字段
- ✅ 后端：移除实体类、DTO、服务中的 `maxPositionCount` 相关代码
- ✅ 后端：移除 `FilterResult` 中的 `FAILED_MAX_POSITION_COUNT` 状态
- ✅ 后端：移除 `CopyTradingFilterService` 中的最大仓位数量检查逻辑
- ✅ 前端：移除类型定义、表单字段和国际化翻译
- ✅ 前端：移除过滤订单列表中的 `MAX_POSITION_COUNT` 类型
**影响范围**：
- `backend/src/main/resources/db/migration/V26__remove_max_position_count.sql` - 数据库迁移
- `backend/src/main/kotlin/com/wrbug/polymarketbot/entity/CopyTrading.kt` - 实体类
- `backend/src/main/kotlin/com/wrbug/polymarketbot/dto/CopyTradingDto.kt` - DTO
- `backend/src/main/kotlin/com/wrbug/polymarketbot/service/copytrading/configs/CopyTradingFilterService.kt` - 过滤服务
- `frontend/src/pages/CopyTradingOrders/AddModal.tsx` - 添加表单
- `frontend/src/pages/CopyTradingOrders/EditModal.tsx` - 编辑表单
- `frontend/src/types/index.ts` - 类型定义
**提交**: e8fd1b5
---
## 🐛 Bug 修复
### 修复TypeScript类型错误
**修复内容**：
- ✅ 修复编译时的TypeScript类型错误
- ✅ 修复Spin导入问题
- ✅ 修复Table fixed类型问题
- ✅ 修复size类型问题
**影响范围**：
- `frontend/src/pages/LeaderList.tsx` - Leader列表页面
**提交**: 8097660
---
## ⚠️ 潜在问题和注意事项
### 1. 数值格式化变更
**影响**：
- 所有数值现在默认显示千分位分隔符
- 如果之前有代码依赖特定的数值格式，可能需要调整
**建议**：
- 检查是否有代码依赖特定的数值格式
- 确认数值显示是否符合预期
### 2. 移除maxPositionCount配置
**影响**：
- 如果之前使用了最大仓位数量限制功能，升级后将不再可用
- 需要手动调整跟单策略
**建议**：
- 升级前检查是否有跟单配置使用了最大仓位数量限制
- 如有需要，可以手动调整跟单策略
### 3. Leader列表显示变更
**影响**：
- Leader列表现在只显示价值大于0的仓位
- 列表布局和显示内容有所调整
**建议**：
- 升级后检查Leader列表显示是否符合预期
- 确认仓位信息是否正确显示
---
## 📊 文件变更统计
- **修改文件数**: 28
- **新增行数**: 1490
- **删除行数**: 897
---
## 🔄 升级建议
1. **检查数值显示**：
- 升级后检查所有数值显示是否符合预期
- 确认千分位分隔符显示正确
2. **检查跟单配置**：
- 如果有使用最大仓位数量限制的配置，需要手动调整
- 确认跟单功能正常工作
3. **检查Leader列表**：
- 升级后检查Leader列表显示是否正确
- 确认仓位信息是否完整
4. **数据库迁移**：
- 升级时会自动执行数据库迁移 V26
- 迁移会删除 `max_position_count` 字段
- 建议在升级前备份数据库
---
## 📝 完整提交列表
- 40081c2 - feat: 为所有数值显示添加千分位分隔符
- e8fd1b5 - 移除跟单最大仓位数量(maxPositionCount)配置
- 390b3ee - feat: 在创建跟单配置时显示Leader资产信息
- 8097660 - fix: 修复TypeScript类型错误
- 17eea01 - refactor: 列表只显示可用余额
- 6980781 - refactor: 移除仓位资产列
- 3350039 - feat: Leader列表显示仓位资产
- 0bdc0c7 - feat: Leader列表优化
---
## 🙏 致谢
感谢所有贡献者和用户的支持与反馈！
docs/zh/DEPLOYMENT_GUIDE.md
+335
View File
@@ -0,0 +1,335 @@
# PolyHermes 一键部署指南
本文档介绍如何使用交互式一键部署脚本快速部署 PolyHermes 应用。
## 📋 前置要求
### 必需软件
- **Docker**: 版本 20.10 或更高
- **Docker Compose**: 版本 2.0 或更高（或 `docker-compose` v1.29+）
### 环境准备
```bash
# macOS 安装 Docker
brew install docker
# Ubuntu/Debian 安装 Docker
curl -fsSL https://get.docker.com | sh
# CentOS/RHEL 安装 Docker
yum install docker-ce docker-ce-cli containerd.io
```
## 🚀 快速开始
### 1. 克隆项目（如果尚未克隆）
```bash
git clone https://github.com/WrBug/PolyHermes.git
cd PolyHermes
```
### 2. 运行部署脚本
```bash
./deploy-interactive.sh
```
### 3. 按提示配置
脚本会引导你完成以下配置：
#### 基础配置
- **服务器端口**：应用对外暴露的端口（默认：80）
- **MySQL 端口**：数据库外部访问端口（默认：3307，避免与本地 MySQL 冲突）
- **时区**：服务器时区（默认：Asia/Shanghai）
#### 数据库配置
- **数据库用户名**：默认为 `root`
- **数据库密码**：回车自动生成 32 字符随机密码
#### 安全配置（关键）
- **JWT 密钥**：回车自动生成 128 字符随机密钥
- **管理员密码重置密钥**：回车自动生成 64 字符随机密钥
- **加密密钥**：用于加密 API Key，回车自动生成 64 字符随机密钥
#### 日志配置
- **Root 日志级别**：第三方库日志级别（默认：WARN）
- 可选：`TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, `OFF`
- **应用日志级别**：应用代码日志级别（默认：INFO）
#### 其他配置
- **Spring Profile**：环境配置（默认：prod）
- **允许预发布版本**：是否允许自动更新到预发布版本（默认：false）
- **GitHub 仓库**：项目仓库地址（默认：WrBug/PolyHermes）
### 4. 确认并部署
配置完成后，脚本会：
1. 生成 `.env` 配置文件
2. 显示配置摘要
3. 请求确认部署
4. 拉取 Docker Hub 镜像
5. 启动服务
6. 执行健康检查
## 📝 配置示例
### 使用默认值部署（推荐）
所有配置项直接回车，脚本会自动生成安全的随机密钥：
```
服务器端口 [默认: 80]: ⏎
MySQL 端口（外部访问） [默认: 3307]: ⏎
时区 [默认: Asia/Shanghai]: ⏎
数据库用户名 [默认: root]: ⏎
数据库密码 [回车自动生成]: ⏎
JWT 密钥 [回车自动生成]: ⏎
管理员密码重置密钥 [回车自动生成]: ⏎
加密密钥（用于加密 API Key） [回车自动生成]: ⏎
Root 日志级别（第三方库） [默认: WARN]: ⏎
应用日志级别 [默认: INFO]: ⏎
Spring Profile [默认: prod]: ⏎
允许预发布版本更新 [默认: false]: ⏎
GitHub 仓库 [默认: WrBug/PolyHermes]: ⏎
```
### 自定义端口部署
如果需要使用不同的端口：
```
服务器端口 [默认: 80]: 8080⏎
MySQL 端口（外部访问） [默认: 3307]: 33306⏎
```
### 开发环境部署
启用 DEBUG 日志：
```
Root 日志级别（第三方库） [默认: WARN]: DEBUG⏎
应用日志级别 [默认: INFO]: DEBUG⏎
```
## 🔧 部署后管理
### 访问应用
部署完成后，访问：
```
http://localhost:80
```
（或你配置的自定义端口）
### 常用命令
```bash
# 查看服务状态
docker compose -f docker-compose.prod.yml ps
# 查看实时日志
docker compose -f docker-compose.prod.yml logs -f
# 仅查看应用日志
docker compose -f docker-compose.prod.yml logs -f app
# 停止服务
docker compose -f docker-compose.prod.yml down
# 重启服务
docker compose -f docker-compose.prod.yml restart
# 更新到最新版本
docker pull wrbug/polyhermes:latest
docker compose -f docker-compose.prod.yml up -d
```
### 数据库连接
使用配置的凭据连接到 MySQL：
```bash
mysql -h 127.0.0.1 -P 3307 -u root -p
# 输入你在部署时设置的数据库密码
```
或使用图形化工具（如 DBeaver、Navicat）：
- **主机**: `localhost`
- **端口**: `3307`（或你配置的端口）
- **数据库**: `polyhermes`
- **用户名**: `root`（或你配置的用户名）
- **密码**: 部署时设置的密码（可在 `.env` 文件中查看）
## 🔐 安全最佳实践
### 保护配置文件
```bash
# 设置 .env 文件权限
chmod 600 .env
# 确保 .env 已添加到 .gitignore
echo ".env" >> .gitignore
```
### 定期更换密钥
生产环境建议定期更换安全密钥：
```bash
# 生成新的 JWT 密钥（128字符）
openssl rand -hex 64
# 生成新的管理员重置密钥（64字符）
openssl rand -hex 32
# 更新 .env 文件后重启服务
docker compose -f docker-compose.prod.yml restart
```
### 备份数据库
```bash
# 备份数据库
docker exec polyhermes-mysql mysqldump -u root -p polyhermes > backup_$(date +%Y%m%d).sql
# 恢复数据库
docker exec -i polyhermes-mysql mysql -u root -p polyhermes < backup_20260201.sql
```
## 🌐 生产环境部署建议
### 1. 使用反向代理
建议使用 Nginx 或 Caddy 作为反向代理：
```nginx
# Nginx 配置示例
server {
listen 443 ssl http2;
server_name polyhermes.yourdomain.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_pass http://localhost:80;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
```
### 2. 配置防火墙
```bash
# UFW (Ubuntu)
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable
# Firewalld (CentOS)
firewall-cmd --add-service=http --permanent
firewall-cmd --add-service=https --permanent
firewall-cmd --reload
```
### 3. 启用自动更新
配置定时任务自动检查并更新镜像：
```bash
# 创建更新脚本
cat > /opt/polyhermes-update.sh <<'EOF'
#!/bin/bash
cd /path/to/PolyHermes
docker pull wrbug/polyhermes:latest
docker compose -f docker-compose.prod.yml up -d
EOF
chmod +x /opt/polyhermes-update.sh
# 添加到 crontab（每天凌晨 3 点检查更新）
echo "0 3 * * * /opt/polyhermes-update.sh >> /var/log/polyhermes-update.log 2>&1" | crontab -
```
## 🐛 故障排查
### 服务无法启动
```bash
# 查看详细错误日志
docker compose -f docker-compose.prod.yml logs
# 检查容器状态
docker compose -f docker-compose.prod.yml ps
```
### 数据库连接失败
```bash
# 检查 MySQL 容器状态
docker logs polyhermes-mysql
# 测试数据库连接
docker exec polyhermes-mysql mysql -u root -p -e "SELECT 1"
```
### 端口被占用
```bash
# 查找占用端口的进程
lsof -i :80
# 或
netstat -tulpn | grep :80
# 修改 SERVER_PORT 环境变量
vim .env # 修改 SERVER_PORT=8080
docker compose -f docker-compose.prod.yml up -d
```
### 镜像拉取失败
如果 Docker Hub 访问受限，可以配置镜像加速器：
```bash
# 配置 Docker 镜像加速器
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com"
]
}
EOF
sudo systemctl restart docker
```
## 📚 更多资源
- [项目 README](../../README.md)
- [发布日志](../../RELEASE.md)
- [GitHub 仓库](https://github.com/WrBug/PolyHermes)
- [问题反馈](https://github.com/WrBug/PolyHermes/issues)
## 📞 获取帮助
如遇到问题，请：
1. 查看上方的**故障排查**章节
2. 检查 [GitHub Issues](https://github.com/WrBug/PolyHermes/issues)
3. 提交新的 Issue 并附上日志输出
---
**祝部署顺利！** 🎉
frontend/src/pages/BacktestList.tsx
+4 -1
View File
@@ -722,7 +722,10 @@ const BacktestList: React.FC = () => {
<Select placeholder={t('backtest.leader')} showSearch>
{leaders.map((leader) => (
<Option key={leader.id} value={leader.id}>
{leader.leaderName || leader.leaderAddress}
<div style={{ display: 'flex', flexDirection: 'column' }}>
<span>{leader.leaderName || `Leader ${leader.id}`}</span>
<span style={{ fontSize: '12px', color: '#999' }}>{leader.leaderAddress}</span>
</div>
</Option>
))}
</Select>