PolyHermes/RELEASE_NOTES.md

## 版本信息
- **版本号**: v1.1.15
- **发布日期**: 2026-01-19
- **基础版本**: v1.1.14

## 改动摘要
本次版本优化了订单详情处理逻辑，提升了系统稳定性和开发体验。

## 主要改动

### 🐛 Bug 修复

#### 1. 优化订单详情为 null 时的处理逻辑
- **提交**: 7385eff
- **文件**: OrderStatusUpdateService.kt
- **问题**: 
  - 订单详情为 null 且已发送通知超过 60 秒时，订单被直接删除
  - 导致已经正确处理并发送 TG 通知的订单被意外删除
- **修复**:
  - 当订单详情为 null 且 notificationSent = true 超过 60 秒时，将订单状态改为 fully_matched
  - fully_matched 状态的订单会被自动过滤，不再查询详情
  - 避免已处理的订单被误删除

### 🧹 日志清理

#### 2. 清理 MarketPollingService 中多余的 debug 日志
- **提交**: d768da7, 07b4d65
- **文件**: MarketPollingService.kt
- **改进**:
  - 删除多余的 debug 日志输出
  - 减少冗余日志，提升日志可读性
  - 优化性能（减少日志 I/O）

### ✨ 新增功能

#### 3. 添加订单详情查询工具脚本
- **提交**: b658270
- **新增文件**: 
  - scripts/get-order-detail.js - 订单详情查询脚本
  - scripts/package.json - 依赖配置文件
- **功能**:
  - 快速查询 Polymarket 订单详情
  - 支持自动创建 API Key
  - 完善的错误处理和参数验证
  - 详细的订单信息输出

## 文件变更统计
- **修改文件数**: 3
- **新增文件数**: 2
- **新增行数**: 192
- **删除行数**: 6

## 技术细节

### 订单状态管理优化
- 使用 fully_matched 状态标记已处理订单
- 通过数据库查询条件自动过滤，无需额外缓存
- 保持数据一致性和可追溯性

### 工具脚本特性
- 基于 Polymarket CLOB Client v5.2.1
- 支持 derive/create API Key 自动处理
- 完整的参数验证和错误提示
- 友好的命令行交互体验

## 升级建议
- 无需特殊操作，直接部署即可
- 建议验证订单处理逻辑是否正常工作
- 可以使用新增的工具脚本进行调试

## 完整提交列表
- 7385eff - 优化订单详情为null时的处理逻辑
- d768da7 - 清理 MarketPollingService 中多余的 debug 日志
- b658270 - 添加订单详情查询脚本
- 07b4d65 - 清理 MarketPollingService 调试日志