From fa1a915e9c203491755f0713a5547b02faa55ffc Mon Sep 17 00:00:00 2001
From: WrBug <iwrbug@gmail.com>
Date: Thu, 29 Jan 2026 04:00:11 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20v2.0.2=20release?=
 =?UTF-8?q?=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 RELEASE_NOTES_v2.0.2.md | 144 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 144 insertions(+)
 create mode 100644 RELEASE_NOTES_v2.0.2.md

diff --git a/RELEASE_NOTES_v2.0.2.md b/RELEASE_NOTES_v2.0.2.md
new file mode 100644
index 0000000..71a38a4
--- /dev/null
+++ b/RELEASE_NOTES_v2.0.2.md
@@ -0,0 +1,144 @@
+# 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): 优化构建流程和通知机制
+
+---
+
+## 🙏 致谢
+
+感谢所有贡献者和用户的支持与反馈！
+