公告

[WrBug]

🚨 重要公告：认准官方渠道，保护您的资产安全

⚠️ 安全提醒

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

✅ 官方 Docker Hub 镜像

官方镜像地址：wrbug/polyhermes

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

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

🔗 官方渠道

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

• GitHub 仓库：https://github.com/WrBug/PolyHermes
• Twitter：@polyHermes
• Telegram 群组：加入群组

🛡️ 安全建议

1. 只从官方 GitHub 仓库下载代码
2. 只使用 Docker Hub 官方镜像 wrbug/polyhermes
3. 验证镜像来源：检查镜像的发布者是否为 wrbug
4. 不要使用第三方提供的镜像或代码
5. 定期检查更新：关注 GitHub Releases 获取最新版本

📢 公告说明

本 Issue 用于发布重要公告和更新信息。您可以在下方回复讨论，但请保持内容与公告相关。

---

⚠️ 再次提醒：使用非官方镜像可能导致您的私钥泄露和资产损失，请务必认准官方渠道！

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

[WrBug]

PolyHermes v1.0.0 发版公告

🎉 版本概述

PolyHermes 是一个功能强大的 Polymarket 预测市场跟单交易系统，支持自动化跟单、多账户管理、实时订单推送和统计分析。本次发版为 v1.0.0 正式版本，包含完整的跟单交易功能。

✨ 核心功能

🔐 账户管理

• ✅ 支持通过私钥导入多个钱包账户
• ✅ 支持助记词、私钥字符串、Keystore 文件导入
• ✅ 私钥和 API 凭证加密存储
• ✅ 账户余额查询（USDC 余额、仓位余额）
• ✅ 账户信息管理（账户名称、API 凭证配置）
• ✅ 多账户统一管理界面

👥 Leader 管理

• ✅ 添加和管理被跟单者（Leader）
• ✅ 支持分类筛选（sports/crypto）
• ✅ Leader 备注和网站信息
• ✅ Leader 统计信息（总订单数、总盈亏）

📊 跟单模板管理

• ✅ 创建和编辑跟单模板
• ✅ 支持比例跟单和固定金额跟单
• ✅ 风险控制参数配置：
  • 每日亏损限制
  • 订单数限制
  • 价格容忍度
  • 最小/最大跟单金额
• ✅ 模板复制功能

🔄 跟单配置

• ✅ 将账户、模板和 Leader 关联
• ✅ 灵活的跟单规则配置
• ✅ 启用/禁用跟单关系
• ✅ 跟单状态实时监控

🔄 自动跟单

• ✅ 实时监控 Leader 交易
• ✅ 自动复制订单（支持买入和卖出）
• ✅ 订单过滤规则（按市场、金额、时间等）
• ✅ 订单执行状态跟踪

📈 订单跟踪

• ✅ 完整的订单生命周期跟踪
• ✅ 买入订单列表
• ✅ 卖出订单列表
• ✅ 订单匹配关系
• ✅ 被过滤订单记录

📊 统计分析

• ✅ 全局统计（所有跟单关系汇总）
• ✅ Leader 统计（特定 Leader 统计信息）
• ✅ 分类统计（按 sports/crypto 分类）
• ✅ 跟单关系统计（单个跟单关系详细统计）
• ✅ 支持时间范围筛选

💼 仓位管理

• ✅ 实时查看和管理持仓
• ✅ 仓位列表（所有账户）
• ✅ 仓位详情（市场、方向、数量、价格）
• ✅ 仓位卖出功能
• ✅ 仓位赎回功能（可赎回仓位）
• ✅ 仓位推送（WebSocket 实时推送）

⚙️ 系统管理

• ✅ 代理配置（HTTP 代理）
• ✅ API 健康检查（Polymarket CLOB API、Data API、Gamma API、Polygon RPC、WebSocket、Builder Relayer API、GitHub API）
• ✅ 系统配置（Builder API Key、自动赎回配置）
• ✅ 实时状态监控

📢 消息推送

• ✅ 支持多种推送方式：
  • Telegram Bot
  • Discord Webhook
  • Slack Webhook
  • 自定义 Webhook
• ✅ 推送配置管理
• ✅ 测试推送功能

📢 公告功能

• ✅ 从 GitHub Issues 获取公告
• ✅ 自动筛选指定 assignees 的评论
• ✅ Markdown 格式渲染
• ✅ 标题自动提取（从评论第一行）
• ✅ 响应式设计（移动端和桌面端）
• ✅ 公告列表和详情展示

👥 用户管理

• ✅ 用户列表查看
• ✅ 用户创建和删除
• ✅ 密码管理（管理员重置密码、用户修改密码）
• ✅ 首次使用检测

🛡️ 安全特性

• ✅ 私钥加密存储（AES 加密）
• ✅ API 凭证加密存储
• ✅ JWT 认证
• ✅ 密码加密存储
• ✅ 敏感数据保护

🌐 技术特性

后端

• ✅ Spring Boot 3.2.0 + Kotlin 1.9.20
• ✅ MySQL 8.2.0 + Flyway 数据库迁移
• ✅ Retrofit 2.9.0 + OkHttp 4.12.0 HTTP 客户端
• ✅ Spring WebSocket 实时推送
• ✅ 异步处理和并发优化
• ✅ 统一 API 响应格式
• ✅ 国际化支持（多语言）

前端

• ✅ React 18 + TypeScript
• ✅ Vite 构建工具
• ✅ Ant Design 5.12.0 UI 库
• ✅ 响应式设计（移动端和桌面端）
• ✅ WebSocket 实时数据推送
• ✅ Markdown 渲染支持
• ✅ 国际化支持（中文简体/繁体、英文）

📱 移动端支持

• ✅ 完美适配移动端和桌面端
• ✅ 响应式布局（移动端 < 768px，桌面端 >= 768px）
• ✅ 触摸友好的交互设计
• ✅ 移动端优化的列表和详情展示

🚀 部署支持

• ✅ Docker 容器化部署
• ✅ 一体化部署脚本（前后端一起部署）
• ✅ 分别部署支持（后端 Java/Docker，前端独立部署）
• ✅ Nginx 反向代理配置
• ✅ 环境变量配置支持

📚 文档

• ✅ 完整的 README 文档
• ✅ 部署文档（DEPLOYMENT.md）
• ✅ 跟单系统需求文档
• ✅ 前端需求文档
• ✅ API 接口文档
• ✅ 开发规范文档

🔧 配置说明

环境变量

• DB_USERNAME: 数据库用户名
• DB_PASSWORD: 数据库密码
• SERVER_PORT: 后端服务端口（默认: 8000）
• JWT_SECRET: JWT 密钥
• POLYGON_RPC_URL: Polygon RPC 地址
• GITHUB_REPO_OWNER: GitHub 仓库所有者
• GITHUB_REPO_NAME: GitHub 仓库名称

功能配置

• 代理配置（通过 Web UI 配置）
• Builder API Key 配置
• 自动赎回配置
• 消息推送配置

🐛 已知问题

• 无

🔮 后续计划

• 更多消息推送方式支持
• 更丰富的统计分析功能
• 性能优化和扩展性提升

📝 更新日志

新增功能

• ✨ 完整的跟单交易系统
• ✨ 多账户管理功能
• ✨ Leader 管理功能
• ✨ 跟单模板和配置管理
• ✨ 自动跟单功能
• ✨ 订单跟踪功能
• ✨ 统计分析功能
• ✨ 仓位管理功能
• ✨ 系统管理功能
• ✨ 消息推送功能
• ✨ 公告功能
• ✨ 用户管理功能

技术改进

• 🔧 后端架构优化
• 🔧 前端响应式设计
• 🔧 WebSocket 实时推送
• 🔧 安全加密存储
• 🔧 国际化支持

[WrBug]

🎉 PolyHermes v1.0.1 版本发布公告

📅 发布日期

2025年12月9日 01:30:00

🚀 主要更新

性能优化

📊 订单簿请求优化

• 优化订单簿获取逻辑，仅在需要时请求，避免不必要的 API 调用
• 当未配置需要订单簿的过滤条件（价差、订单深度）时，跳过订单簿获取
• 订单簿只请求一次，在过滤检查中复用，提高性能

💰 卖出价格计算优化

• 卖出改为市价卖出：优先使用订单簿的 bestBid（最高买入价）
• 如果 bestBid 获取失败，自动降级使用 Leader 的交易价格
• 卖出价格固定按 90% 计算，不再使用价格容忍度配置
• 提高卖出订单的成交率

⚙️ 价格容忍度默认值

• 如果价格容忍度配置为 0，自动使用默认值 5%
• 确保买入订单能够正常应用价格调整，提高成交率

代码优化

🎯 使用枚举优化过滤逻辑

• 新增 FilterResult 数据类和 FilterStatus 枚举
• 使用类型安全的枚举替代字符串判断，提高代码可维护性
• 移除无用字段 isBuyOrder 参数
• 优化 checkFilters 方法返回值，使用数据类封装结果

📝 代码结构优化

• 减少 if-else 嵌套，使用 Kotlin 链式调用和空安全操作符
• 优化卖出价格计算逻辑，使用 runCatching 和 ?.let 简化代码
• 提取公共方法 calculateFallbackSellPrice，提高代码复用性

功能改进

🗑️ 移除最小订单簿深度功能

• 移除 minOrderbookDepth（最小订单簿深度）配置项
• 简化过滤逻辑，只保留 minOrderDepth（最小订单深度）
• 更新前端界面，移除相关配置项和提示文案

📈 优化最小订单深度逻辑

• 修改 minOrderDepth 检查逻辑，检查所有方向（买盘+卖盘）的总深度
• 不再区分买卖方向，提供更全面的市场流动性评估

🎯 市场结算判断优化

• 添加市场已关闭时的结算判断逻辑
• 如果市场已关闭且该 outcome 赢了（价格 >= 0.99），返回价格为 1
• 如果市场已关闭且该 outcome 输了（价格 <= 0.01），返回价格为 0
• 当没有仓位但有未完成订单时，正确判断市场结算状态并设置价格

Bug 修复

• ✅ 修复盈亏和持仓价值计算逻辑未实现的问题
• ✅ 修复过滤检查中订单簿可能重复请求的问题

📦 如何更新

Docker 部署

# 拉取最新镜像
docker pull wrbug/polyhermes:v1.0.1

# 或使用 latest 标签
docker pull wrbug/polyhermes:latest

# 重启容器
docker-compose down
docker-compose up -d

源码部署

# 拉取最新代码
git fetch origin
git checkout v1.0.1

# 重新构建
cd backend
./gradlew bootJar

# 重启服务
# 根据您的部署方式重启服务

📚 文档更新

• 更新前端多语言文案，优化提示信息
• 移除最小订单簿深度相关的文档说明

🔗 相关链接

• GitHub Release: https://github.com/WrBug/PolyHermes/releases/tag/v1.0.1
• 完整更新日志: v1.0.0...v1.0.1
• Docker Hub: https://hub.docker.com/r/wrbug/polyhermes

⚠️ 重要提醒

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

✅ 官方 Docker Hub 镜像

官方镜像地址：wrbug/polyhermes

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

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

[WrBug]

🎉 PolyHermes v1.0.2 版本发布公告

系统配置优化

• 系统配置支持显示完整的 Builder API Key（不再部分显示）
• Secret 和 Passphrase 使用密码输入框，支持眼睛图标切换显示/隐藏
• 移除已配置提示，简化用户界面

统计功能修复

• 修复总卖出金额统计：使用 SellMatchDetail 计算，确保准确性
• 修复 matchSellOrder 中价格不一致问题：matchDetails 使用实际卖出价格

UI 优化

• 移动端 Leader 列表移除网站显示行

订单创建优化

• 优化订单创建前订单簿匹配检查，避免 FAK 订单失败
• 重试延迟从 1 秒调整为 3 秒
• 优化跟单买入和重试逻辑，使用常量配置

[WrBug]

v1.0.3: 添加最大仓位限制配置功能

🎯 主要更新

📊 最大仓位限制功能

• 最大仓位金额限制：支持设置单个市场的最大仓位金额（USDC）
  • 当该市场的当前仓位金额 + 跟单金额超过限制时，订单将被过滤
  • 支持按市场维度进行仓位控制，而非全局限制
• 最大仓位数量限制：支持设置单个市场的最大仓位数量
  • 当该市场的当前仓位数量达到或超过限制时，订单将被过滤
• 灵活配置：两个限制可以同时启用，也可以单独使用
  • 不填写则表示不启用该限制

🔧 组件重构与优化

• 可复用组件提取：

  • 创建 AccountImportForm 组件，封装账户导入表单逻辑
  • 创建 LeaderAddForm 组件，封装 Leader 添加表单逻辑
  • 提高代码复用性和可维护性

• 用户体验优化：

  • 在添加跟单配置页面集成账户导入和 Leader 添加 Modal
  • 当选择钱包为空时，提供"导入账户"按钮，可在弹窗中直接导入
  • 当选择 Leader 为空时，提供"添加 Leader"按钮，可在弹窗中直接添加
  • 导入/添加成功后自动选中新创建的项目，无需手动刷新

🌐 多语言完善

• 补充缺失键：使用脚本对比发现并补充了所有多语言文件中的缺失键
• 统一键结构：确保 zh-CN、zh-TW、en 三种语言文件的键结构完全一致
• 新增翻译：
  • 最大仓位限制相关的所有字段和提示信息
  • Modal 标题、按钮文本等交互元素

🗄️ 数据库变更

• 新增迁移脚本 V11__add_max_position_config.sql
• 在 copy_trading 表中添加字段：
  • max_position_value：最大仓位金额（DECIMAL(20, 8)，可为 NULL）
  • max_position_count：最大仓位数量（INT，可为 NULL）

🔍 后端实现

• 过滤逻辑：

  • 在 CopyTradingFilterService 中实现仓位限制检查
  • 通过 AccountService 获取当前账户的所有仓位信息
  • 按市场过滤仓位，只检查当前市场的仓位情况
  • 返回详细的过滤原因，便于调试和问题排查

• 过滤状态：

  • 新增 FAILED_MAX_POSITION_VALUE 过滤状态
  • 新增 FAILED_MAX_POSITION_COUNT 过滤状态
  • 在已过滤订单列表中可查看过滤原因

🎨 前端实现

• 配置页面：

  • 在添加跟单配置页面新增"最大仓位限制"配置区块
  • 在编辑跟单配置页面新增"最大仓位限制"配置区块
  • 在订单列表的编辑 Modal 中也支持配置最大仓位限制

• 过滤展示：

  • 在已过滤订单列表中显示仓位限制过滤的原因
  • 支持按过滤类型筛选，包括新增的两种仓位限制类型

📝 使用说明

配置最大仓位限制

1. 最大仓位金额：

   • 在跟单配置中填写"最大仓位金额 (USDC)"
   • 例如：设置为 100，表示该市场的仓位总金额不能超过 100 USDC
   • 不填写则表示不限制仓位金额

2. 最大仓位数量：

   • 在跟单配置中填写"最大仓位数量"
   • 例如：设置为 10，表示该市场的仓位数量不能超过 10 个
   • 不填写则表示不限制仓位数量

3. 仓位检查逻辑：

   • 系统会在下单前检查当前市场的仓位情况
   • 如果超过任一限制，订单将被过滤，不会执行
   • 过滤的订单会记录在"已过滤订单列表"中，可查看具体原因

🐛 Bug 修复

• 修复了多语言文件键不一致导致的部分文本显示缺失的问题
• 修复了账户导入和 Leader 添加页面代码重复的问题
• 修复了前端编译错误（移除未使用的导入和参数）

📚 代码优化

• 重构账户导入和 Leader 添加功能为可复用组件
• 统一多语言文件结构，确保三种语言文件的键完全一致
• 优化组件导入和导出，提高代码可维护性
• 修复 TypeScript 编译警告，确保代码质量

[WrBug]

🎉 v1.1.0 版本更新指南

📅 发布日期

2025年12月26日

🎯 这次更新对您意味着什么？

⚡ 更快的跟单响应速度

• 实时链上监听：通过 WebSocket 实时监听链上交易，跟单秒级响应
• 双重保障：链上监听和轮询同时运行，确保不错过任何交易机会
• 自动去重：系统自动处理重复数据，确保每笔交易只执行一次

💰 更准确的盈亏统计

• 实际成交价追踪：系统会自动更新卖出订单的实际成交价，而不是下单时的价格
• 自动价格更新：每 5 秒自动查询并更新订单的实际成交价
• 精确盈亏计算：基于实际成交价计算盈亏，统计数据更准确

🔧 更灵活的系统配置

• RPC 节点管理：可以添加、编辑、删除自定义 RPC 节点
• 节点启用/禁用：可以随时启用或禁用节点，无需删除配置
• 智能节点选择：系统自动选择可用的节点，禁用的节点会被忽略

🐛 问题修复

• 修复卖出订单失败问题：修复了部分情况下卖出订单因 API 凭证问题导致的失败
• 修复订单精度错误：修复了卖出订单因精度问题导致的 API 错误

📦 如何更新

方式一：使用 Docker（推荐）

步骤 1：备份数据（强烈推荐）

备份不是必须的，但强烈推荐！

为什么需要备份？

• Docker 更新不会删除数据（数据存储在独立的数据卷中）
• 但数据库结构可能会变更（本次更新会添加 price_updated 字段）
• 如果迁移失败或出现问题，备份可以帮助恢复数据
• 生产环境建议必须备份，开发环境可以跳过

如何备份？

# 方式 1：使用 mysqldump 备份数据库（推荐）
docker exec polyhermes-mysql mysqldump -u root -p polyhermes > backup_$(date +%Y%m%d_%H%M%S).sql

# 方式 2：备份整个 MySQL 数据卷
docker run --rm -v polyhermes_mysql-data:/data -v $(pwd):/backup alpine tar czf /backup/mysql_backup_$(date +%Y%m%d_%H%M%S).tar.gz /data

# 方式 3：如果已有定期备份，可以跳过此步骤

什么情况下可以跳过备份？

• ✅ 开发环境或测试环境
• ✅ 数据不重要或可以重新生成
• ✅ 已经有定期自动备份
• ✅ 确定迁移不会失败（查看更新日志确认）

什么情况下必须备份？

• ⚠️ 生产环境
• ⚠️ 包含重要交易数据
• ⚠️ 不确定迁移是否安全

步骤 2：停止当前服务

# 进入部署目录
cd /path/to/polyhermes

# 停止服务
docker-compose -f docker-compose.prod.yml down

步骤 3：拉取新版本

# 拉取 v1.1.0 版本
docker pull wrbug/polyhermes:v1.1.0

# 或者拉取最新版本（推荐）
docker pull wrbug/polyhermes:latest

步骤 4：更新配置（如果需要）

如果您想固定使用 v1.1.0 版本，可以编辑 docker-compose.prod.yml：

services:
  app:
    image: wrbug/polyhermes:v1.1.0  # 修改这里

步骤 5：启动服务

# 启动服务
docker-compose -f docker-compose.prod.yml up -d

# 查看日志，确认服务正常启动
docker-compose -f docker-compose.prod.yml logs -f

步骤 6：验证更新

1. 访问系统首页，查看页面标题是否显示 v1.1.0
2. 检查系统功能是否正常
3. 查看日志是否有错误信息

方式二：一键更新脚本

如果您使用 latest 标签，可以使用以下命令一键更新：

# 进入部署目录
cd /path/to/polyhermes

# 拉取最新镜像并重启
docker-compose -f docker-compose.prod.yml pull
docker-compose -f docker-compose.prod.yml up -d

# 查看日志
docker-compose -f docker-compose.prod.yml logs -f

⚠️ 更新注意事项

1. 数据库迁移

• 本次更新会自动执行数据库迁移（添加 price_updated 字段）
• 迁移过程不会影响现有数据，只是添加新字段
• 迁移是安全的，但如果迁移失败，请检查数据库权限和连接
• 如果迁移失败，可以使用备份恢复数据

2. 服务中断时间

• 更新过程中服务会短暂中断（通常 1-2 分钟）
• 建议在低峰期进行更新
• 更新期间正在进行的跟单操作可能会受影响

3. 配置检查

• 更新后请检查 RPC 节点配置是否正确
• 如果使用自定义 RPC 节点，请确认节点状态正常

4. 功能验证

更新后建议验证以下功能：

• ✅ 跟单功能是否正常
• ✅ 订单价格更新是否正常
• ✅ RPC 节点管理是否正常
• ✅ 盈亏统计是否准确

🆕 新功能使用指南

1. RPC 节点管理

如何添加自定义 RPC 节点？

1. 登录系统，进入 系统设置 → RPC 节点设置
2. 点击 添加节点 按钮
3. 填写节点信息：
   • 节点名称：给节点起个名字（如：Alchemy Polygon）
   • RPC URL：节点的 HTTP/HTTPS 地址
   • 启用状态：默认启用，可以稍后禁用
4. 点击 保存

如何启用/禁用节点？

1. 在 RPC 节点列表中，找到要操作的节点
2. 点击 启用/禁用 开关
3. 系统会自动更新节点状态

提示：

• 禁用的节点不会被使用，但配置会保留
• 可以随时重新启用禁用的节点
• 建议至少保留一个启用的节点

2. 实际成交价追踪

这个功能做什么？

系统会自动追踪卖出订单的实际成交价，而不是使用下单时的价格。这样可以：

• 更准确地计算盈亏
• 了解订单的实际执行情况
• 优化卖出策略

如何查看实际成交价？

1. 进入 跟单统计 → 卖出订单
2. 查看订单列表，卖出价格 列显示的是实际成交价
3. 如果价格旁边有更新标记，说明价格已从订单详情中获取

注意：

• 价格更新是自动的，每 5 秒检查一次
• 如果订单还未成交，价格可能还是下单时的价格
• 部分成交的订单会使用加权平均价格

🔍 常见问题

Q1: 更新后无法启动怎么办？

A: 请按以下步骤排查：

1. 检查日志：docker-compose -f docker-compose.prod.yml logs
2. 检查数据库连接是否正常
3. 检查端口是否被占用
4. 如果问题持续，可以回退到之前的版本：

   # 修改 docker-compose.prod.yml 中的镜像标签为之前的版本
   # 例如：image: wrbug/polyhermes:v1.0.3
   docker-compose -f docker-compose.prod.yml up -d

Q2: 更新后跟单不工作怎么办？

A: 请检查：

1. RPC 节点是否正常（进入 RPC 节点设置查看）
2. 跟单配置是否启用
3. 账户 API 凭证是否有效
4. 查看系统日志是否有错误信息

Q3: 如何回退到之前的版本？

A: 按以下步骤操作：

1. 停止当前服务：docker-compose -f docker-compose.prod.yml down
2. 修改 docker-compose.prod.yml 中的镜像标签为之前的版本
3. 启动服务：docker-compose -f docker-compose.prod.yml up -d

注意：回退版本时，数据库结构可能不兼容，建议先备份数据库。

Q4: 更新后数据会丢失吗？

A: 不会。更新过程不会删除任何数据。但为了安全起见，建议更新前备份数据库。

Q5: 如何查看当前版本？

A: 有两种方式：

1. 页面查看：登录系统后，页面标题会显示版本号（如：PolyHermes v1.1.0）
2. 命令行查看：

   docker inspect polyhermes | grep -i version

📚 相关文档

• 完整更新日志
• 部署文档
• 版本管理文档

🔗 获取帮助

如果更新过程中遇到问题：

1. 查看 GitHub Issues
2. 查看系统日志：docker-compose -f docker-compose.prod.yml logs -f
3. 在 GitHub 上提交 Issue，描述您的问题

⚠️ 安全提醒

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

✅ 官方 Docker Hub 镜像

官方镜像地址：wrbug/polyhermes

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

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

💬 如有问题或建议，欢迎在 GitHub Issues 中反馈。

[WrBug]

PolyHermes v1.1.2 版本更新指南

🎉 发布日期: 2026-01-01

---

✨ 本次更新亮点

🚀 性能大幅提升

• 修复内存泄漏问题：系统运行更稳定，内存占用不再持续增长
• 优化市场价格查询：查询速度更快，响应更及时
• 代码架构优化：系统运行更流畅，资源占用更低

🛡️ 稳定性改进

• 修复数据库迁移相关问题，确保升级过程更顺畅
• 优化错误处理机制，提供更清晰的错误提示

📚 新增文档

• 新增智能资金分析功能使用文档，帮助您更好地使用相关功能

---

🎯 主要改进

1. 内存优化（重要）

• 优化了网络连接管理，复用连接资源
• 修复了内存泄漏问题
• 效果：内存占用保持稳定，不再持续增长

对您的影响：

• ✅ 系统可以长时间稳定运行
• ✅ 服务器资源占用更低
• ✅ 运行更流畅

2. 市场价格查询优化

改进：

• 简化了价格查询逻辑，提高查询效率
• 价格精度更准确（保留 4 位小数）
• 查询失败时提供更明确的错误提示

对您的影响：

• ✅ 价格查询更快
• ✅ 价格显示更准确
• ✅ 错误提示更清晰

3. 代码架构优化

改进：

• 统一了代码架构，提高可维护性
• 优化了系统内部处理逻辑

[WrBug]

🎉 PolyHermes v1.1.7 发布公告

发布日期：2026年1月7日

---

✨ 新功能

💰 支持 Maker Rebates Program 费率

我们新增了对 Polymarket Maker Rebates Program 的支持！系统现在会自动获取并应用最新的费率，帮助您享受更优惠的交易成本。

这意味着什么？

• 系统会自动查询并应用最新的费率
• 所有订单（买入、卖出）都会使用正确的费率
• 无需手动配置，系统会自动处理

🔧 Docker 部署更灵活

现在您可以通过环境变量轻松配置日志级别，无需修改配置文件！

新增配置项：

• LOG_LEVEL_ROOT - 系统日志级别（默认：INFO）
• LOG_LEVEL_APP - 应用日志级别（默认：DEBUG）

只需在 .env 文件中添加这些配置，重启服务即可生效。

---

🐛 问题修复

修复市场价格查询问题

修复了某些市场无法正确查询价格的问题。现在系统会：

• 优先从链上查询市场价格
• 如果链上查询失败，自动降级到其他数据源
• 提高系统的稳定性和容错性

修复自动卖出误判问题

修复了在某些情况下系统会误判市场已卖出，导致创建错误记录的问题。现在系统会：

• 更准确地判断市场状态
• 避免误判导致的错误记录
• 提高仓位管理的准确性

---

📝 文档更新

更新联系方式

• Telegram 群组：https://t.me/polyhermes
  • 欢迎加入我们的 Telegram 群组，获取最新资讯和技术支持！

版本信息更清晰

• README 中新增了 Docker 版本徽章
• 可以一目了然地看到最新的 Docker 镜像版本

---

📊 本次更新统计

• 5 个提交
• 16 个文件变更
• 主要改进：费率支持、错误修复、部署优化

---

🚀 如何升级

Docker 部署用户（推荐）

# 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

# 4. 查看日志确认升级成功
docker-compose -f docker-compose.prod.yml logs -f

本地构建用户

# 1. 拉取最新代码
git pull origin dev

# 2. 切换到 v1.1.7 标签
git checkout v1.1.7

# 3. 重新构建并启动
./deploy.sh

---

⚠️ 重要提示

数据库迁移

本次更新无需数据库迁移，可以直接升级，不会影响现有数据。

配置变更

• 新增的日志级别配置为可选配置
• 如果不配置，系统会使用默认值（INFO/DEBUG）
• 不影响现有功能

---

🙏 感谢

感谢所有用户的支持和反馈！如果您在使用过程中遇到任何问题，欢迎：

• 📧 提交 Issue：https://github.com/WrBug/PolyHermes/issues
• 💬 加入 Telegram 群组：https://t.me/polyhermes
• 🐦 关注 Twitter：@polyhermes

---

📚 相关链接

• GitHub 仓库：https://github.com/WrBug/PolyHermes
• 完整更新日志：https://github.com/WrBug/PolyHermes/releases/tag/v1.1.7
• Docker Hub：https://hub.docker.com/r/wrbug/polyhermes

---

祝您交易顺利！ 🚀

[WrBug]

🎉 PolyHermes v2.0.0 发布公告

📋 更新摘要

PolyHermes v2.0.0 是一个重要版本更新，带来了系统动态更新功能，让您无需重启 Docker 容器即可完成系统更新。同时优化了用户体验和多项技术改进。

---

✨ 核心新功能

🔄 系统动态更新（重磅功能）

无需重启 Docker 容器即可更新系统，大幅提升部署和维护效率！

主要特性

• ✅ 在线更新：在 Web UI 中一键检查并应用更新，无需手动操作
• ✅ 零停机更新：更新过程约 30-60 秒，系统自动处理
• ✅ 自动回滚：更新失败时自动恢复到旧版本，确保系统稳定性
• ✅ 版本管理：清晰显示当前版本和可用更新，支持 Pre-release 版本检测
• ✅ 更新内容展示：支持 Markdown 格式的更新说明，美观易读

技术实现

• 独立的 Python Flask 更新服务（端口 9090），与主应用隔离
• 单一更新包（tar.gz），包含前后端完整更新
• 自动备份和版本管理
• 管理员权限验证，确保安全性

📦 Release 管理工具

新增自动化发布脚本，简化版本发布流程：

• 自动创建 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
• 与标题垂直居中对齐
• 响应式设计，完美支持移动端和桌面端

---

📝 完整更新日志

新增功能

• 系统动态更新功能（无需重启容器）
• 自动备份和回滚机制
• 版本管理和检测（支持 Pre-release）
• Markdown 格式的更新内容展示
• 自动化 Release 创建脚本
• 版本号智能显示（带颜色提示）

优化

• 系统更新模块移至系统设置页面最上方
• 版本号使用 Tag 格式显示
• 健康检查等待时间增加到 90 秒
• 后端启动日志输出到文件，便于问题诊断
• 改进错误诊断信息

修复

• 修复 Docker 构建时找不到前端产物的问题
• 修复前端构建时版本号未正确传递的问题
• 修复 GitHub Actions 构建错误（Gradle Wrapper）
• 修复 TypeScript 编译错误
• 修复系统更新 API 路由错误（/update/execute → /update/update）

---

📊 版本信息

• 版本号: v2.0.0
• 发布日期: 2026-01-21
• 变更统计: +5251 行，-163 行
• 新增文件: 17 个
• 修改文件: 13 个

---

🔄 如何升级

方式一：使用动态更新功能（推荐）

1. 登录系统，进入 系统设置 → 系统更新
2. 点击 检查更新
3. 如果有新版本，点击 立即升级
4. 等待更新完成（约 30-60 秒）
5. 页面会自动刷新，更新完成

方式二：重新部署 Docker 容器

# 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 的数据结构和配置

---

📚 技术文档

• 动态更新技术方案
• Docker 版本管理
• 部署指南
• Release 脚本使用说明

---

🙏 致谢

感谢所有使用 PolyHermes 的用户和贡献者！您的反馈和支持是我们不断改进的动力。

---

📥 问题反馈

如果您在使用过程中遇到任何问题，请通过以下方式反馈：

• GitHub Issues: 提交问题
• GitHub Discussions: 参与讨论
• Twitter: @polyhermes

---

📥 下载地址

• Docker Hub: wrbug/polyhermes:v2.0.0
• GitHub Release: v2.0.0

---

© 2024 PolyHermes. 采用 MIT 许可证开源。

⚠️ 免责声明：本软件仅供学习和研究使用。使用本软件进行交易的风险由用户自行承担。

[WrBug]

🎉 PolyHermes v2.3.0 发布公告

尾盘策略功能（加密市场尾盘策略）

1. 核心能力

• 策略 CRUD：创建/更新/删除/查询尾盘策略，支持多账户、多市场。
• 触发与下单：基于 CLOB 订单簿 WebSocket 订阅，价格满足时间窗口与价差条件时自动下单（固定价 0.99）。
• 时间窗口：按 K 线周期（如 5 分钟）配置「区间开始～区间结束」秒数，仅在窗口内检查触发。
• 价格区间：最低价～最高价过滤；最小价差支持三种模式：
  • NONE：不校验价差
  • FIXED：固定点数
  • AUTO：基于币安 BTC 历史 K 线 IQR 剔除后 × 动态系数（50% 基准），按毫秒 progress 计算
• 投入方式：固定金额（USDC）或比例（账户可用余额百分比）。
• 结算与收益：轮询未结算触发记录，拉取 activity 成交数据回写 realizedPnl、winnerOutcomeIndex 等，支持总收益与胜率统计。

前端与体验

• 策略列表页（CryptoTailStrategyList）：列表/卡片（移动端）、账户筛选、状态筛选；状态列（Switch）PC 端第一列；账户列、时间区间（PC 换行/移动端单行）、价格区间、投入方式、总收益、胜率；操作：编辑、订单、删除。
• 触发记录弹窗：成功/失败分 Tab，失败展示失败原因；分页；按天时间范围（日历，结束日不超过今天）；时间范围卡片、空状态、分页总数；订单按钮文案为「订单」。
• 表单：编辑时账户与市场不可修改；策略名称 placeholder「选填，留空将自动生成」；最小价差 NONE/FIXED/AUTO 及前端默认与文案。
• 币安 API 状态：策略页展示币安 API/WS 不可用时的告警与重新检测。
• 多语言（zh-CN/zh-TW/en）与 i18n 键补全。

订单相关 Bug 修复（重点）

1. 订单签名 salt 并发碰撞（fix(order)）

• 问题：在高并发或尾盘策略 FIXED 模式预签双单等场景下，generateSalt() 可能生成相同 salt，导致订单冲突或 invalid。
• 修复：OrderSigningService 使用 AtomicLong + 时间戳 生成 salt，保证同一毫秒内多次调用也唯一（时间戳主位 + 自增序列次位），与 Polymarket/TypeScript SDK 语义兼容。
• Commit：5074bb4 fix(order): 修复订单签名 salt 并发碰撞问题。

2. 跟单 invalid signature 与 orderbook 不存在（fix(copytrading)）

• 问题：跟单下单时出现 invalid signature；部分市场 orderbook 不存在或 tokenId/合约选择错误。
• 修复：
  • tokenId：Activity 解析时写入 trade.tokenId=asset，链上解析时写入 tokenId，优先使用与 CLOB 一致。
  • Neg Risk 市场：从 Gamma 读取 negRisk，按市场选择 CTF Exchange 或 Neg Risk Exchange 签约；否则用错合约会 invalid signature。
  • 签名：OrderSigningService 支持 exchangeContract 参数；Credentials 路径与 v 提取、EIP-712 与链上一致。
  • 校验：创建订单前校验 signer 与 account.walletAddress 一致。
  • 数据层：TradeResponse/EventResponse/MarketResponse 增加 tokenId、negRisk 等字段；MarketService 增加 getMarketInfoByTokenId、getNegRiskByConditionId。
• Commit：63ce410 fix(copytrading): 修复跟单 invalid signature 与 orderbook 不存在。

---

其他重要修复与优化

• 账户/赎回：无跟单配置的账户也执行自动赎回，支持仅用尾盘策略的账户仓位赎回（PositionCheckService）。
• 尾盘下单失败：取消重试并打印完整报错信息；已结算触发不再请求 getOrder，直接标记 notification_sent。
• 健康检查：新增币安 API ping、币安 WebSocket 连接状态；订单簿 bids 空防护；自动价差历史 K 线由 30 根改为 20 根。
• 前端：加密尾盘策略列表编辑与展示修复；策略列表文案换行、列宽、移动端 Switch 位置与时间区间单行等体验优化。

[WrBug]

🎉 PolyHermes v2.4.0 版本发布公告

📅 发布日期

2026年3月2日

---

✨ 本次更新亮点

🚀 新功能

消息推送自定义模板

• 现在可以自定义 Telegram 通知的内容格式，使用 {{variable}} 语法插入变量
• 新增独立的消息推送设置页面，方便管理机器人配置和模板
• 点击变量即可快速复制，悬停可查看说明

加密价差策略收益曲线

• 新增收益曲线可视化图表，直观查看策略收益变化
• 支持今日、7天、30天、全部时间四种筛选维度
• 统计卡片展示累计收益、最大回撤等关键指标

订单按实际成交价展示

• 订单通知现在显示真实的平均成交价格
• 数量展示更准确，与实际成交一致

🔧 改进优化

UI/UX 优化

• Leader 列表和跟单列表：操作按钮改为图标样式，更简洁美观
• 仓位管理：表格列数从12列精简为8列，信息更紧凑
• 多个列表页面添加空状态提示，体验更友好

移动端优化

• 消息设置页面：修复了点击复制变量失败的问题
• 加密价差监控：下单弹窗改为底部弹出样式，刷新页面后保留策略选择

通知推送优化

• 赎回通知现在会区分输赢：赢的仓位显示"赎回成功"，输的显示"已结算"
• 买入/卖出/赎回通知都会显示钱包可用余额

🐛 问题修复

• 修复卖出订单通知的市场方向显示错误
• 修复创建订单失败时错误信息不显示的问题

---

📦 如何更新

Docker 部署（推荐）

# 拉取最新镜像
docker pull wrbug/polyhermes:v2.4.0

# 重启服务
docker-compose -f docker-compose.prod.yml down
docker-compose -f docker-compose.prod.yml up -d

---

⚠️ 安全提醒

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

官方镜像地址：wrbug/polyhermes

---

📚 相关链接

• GitHub Release: https://github.com/WrBug/PolyHermes/releases/tag/v2.4.0
• Docker Hub: https://hub.docker.com/r/wrbug/polyhermes