# 🎉 v1.0.1 版本发布公告

## 📅 发布日期

2025年12月（具体日期待定）

## 🚀 主要更新

### 性能优化

#### 📊 订单簿请求优化
- 优化订单簿获取逻辑，仅在需要时请求，避免不必要的 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 修复

- ✅ 修复盈亏和持仓价值计算逻辑未实现的问题
- ✅ 修复过滤检查中订单簿可能重复请求的问题
- ✅ 修复健康检查路径不一致问题（从 `/api/health` 改为 `/api/system/health`）

## 📦 如何更新

### Docker 部署

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

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

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

### 源码部署

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

# 重新构建
cd backend
./gradlew bootJar

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

## 📚 文档更新

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

## 🔗 相关链接

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

## ⚠️ 重要提醒

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

### ✅ 官方 Docker Hub 镜像

**官方镜像地址**：`wrbug/polyhermes`

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

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

### 🔗 官方渠道

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

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

---

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

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