docs: 添加 v2.0.2 release notes

- 添加 workflow_dispatch 支持手动触发构建
- Release 事件默认只打包产物（在线升级），不构建 Docker
- 手动触发可选择构建类型：在线升级或 Docker 升级
- 优化 Telegram 通知文案，区分构建类型和升级路径
- 在线升级任务不发送开始通知，只发送完成通知
- 手动触发时产物上传为 Artifact，Release 事件上传到 Release Assets

.github/workflows/docker-build.yml

@@ -4,6 +4,24 @@ on:
   release:
     types:
       - published  # 当通过 GitHub Releases 页面创建 release 时触发
+  workflow_dispatch:
+    inputs:
+      build_type:
+        description: '构建类型'
+        required: true
+        type: choice
+        options:
+          - package-only        # 只打包产物
+          - package-and-docker # 打包产物 + Docker 镜像
+        default: 'package-and-docker'
+      version:
+        description: '版本号（例如: v1.0.0）'
+        required: false
+        type: string
+      tag_name:
+        description: 'Git Tag 名称（留空则使用 version）'
+        required: false
+        type: string
 
 jobs:
   build-and-push:
@@ -16,25 +34,61 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
         with:
-          ref: ${{ github.event.release.tag_name }}  # 使用 release 对应的 tag
+          ref: ${{ github.event.release.tag_name || github.event.inputs.tag_name || github.event.inputs.version || github.ref }}
+      
+      - name: Determine build type
+        id: build_config
+        run: |
+          # 确定构建类型
+          if [ "${{ github.event_name }}" = "release" ]; then
+            # Release 事件：默认只打包产物（不构建 Docker）
+            BUILD_TYPE="package-only"
+            echo "📦 Release 事件：将只打包产物（不构建 Docker）"
+          else
+            # workflow_dispatch 事件：使用用户输入
+            BUILD_TYPE="${{ github.event.inputs.build_type }}"
+            echo "🔧 手动触发：构建类型 = ${BUILD_TYPE}"
+          fi
+          
+          echo "BUILD_TYPE=${BUILD_TYPE}" >> $GITHUB_OUTPUT
       
       - name: Extract version and check if pre-release
         id: extract_version
         run: |
-          # 从 release tag 中提取版本号（例如 v1.0.0 -> 1.0.0）
-          TAG_NAME="${{ github.event.release.tag_name }}"
-          if [ -z "$TAG_NAME" ]; then
-            TAG_NAME=${GITHUB_REF#refs/tags/}
+          # 从不同事件源提取版本号
+          if [ "${{ github.event_name }}" = "release" ]; then
+            # Release 事件：从 release tag 中提取
+            TAG_NAME="${{ github.event.release.tag_name }}"
+            IS_PRERELEASE="${{ github.event.release.prerelease }}"
+          else
+            # workflow_dispatch 事件：从输入参数中提取
+            TAG_NAME="${{ github.event.inputs.tag_name }}"
+            if [ -z "$TAG_NAME" ]; then
+              TAG_NAME="${{ github.event.inputs.version }}"
+            fi
+            # 如果仍然为空，尝试从 git ref 中提取
+            if [ -z "$TAG_NAME" ]; then
+              TAG_NAME=${GITHUB_REF#refs/tags/}
+              if [ "$TAG_NAME" = "$GITHUB_REF" ]; then
+                # 不是 tag，尝试从分支名或 commit SHA 获取
+                TAG_NAME=${GITHUB_REF#refs/heads/}
+                if [ "$TAG_NAME" = "$GITHUB_REF" ]; then
+                  TAG_NAME="dev-$(date +%Y%m%d-%H%M%S)"
+                  echo "⚠️  未指定版本号，使用临时版本: $TAG_NAME"
+                fi
+              fi
+            fi
+            IS_PRERELEASE="false"
           fi
           
           # 验证版本号格式：v数字.数字.数字[-后缀]（例如 v1.0.0, v2.10.102, v1.0.0-beta）
-          if [[ ! "$TAG_NAME" =~ ^v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.-]+)?$ ]]; then
-            echo "错误: 版本号格式不正确，应为 v数字.数字.数字 或 v数字.数字.数字-后缀 (例如: v1.0.0, v1.0.0-beta)"
-            exit 1
+          if [[ ! "$TAG_NAME" =~ ^v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.-]+)?$ ]] && [[ ! "$TAG_NAME" =~ ^dev- ]]; then
+            echo "⚠️  警告: 版本号格式不符合标准，但仍将继续构建"
+            echo "   当前版本号: $TAG_NAME"
+            echo "   标准格式应为: v数字.数字.数字 或 v数字.数字.数字-后缀 (例如: v1.0.0, v1.0.0-beta)"
           fi
           
-          VERSION=${TAG_NAME#v}  # 移除 v 前缀
-          IS_PRERELEASE="${{ github.event.release.prerelease }}"
+          VERSION=${TAG_NAME#v}  # 移除 v 前缀（如果存在）
           
           echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
           echo "TAG=$TAG_NAME" >> $GITHUB_OUTPUT
@@ -47,7 +101,7 @@ jobs:
           fi
       
       - name: Send Telegram notification (build started)
-        if: steps.extract_version.outputs.IS_PRERELEASE == 'false'
+        if: steps.extract_version.outputs.IS_PRERELEASE == 'false' && steps.build_config.outputs.BUILD_TYPE == 'package-and-docker'
         env:
           TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
           TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}
@@ -59,12 +113,15 @@ jobs:
           fi
           
           # 获取构建信息
-          VERSION="${{ steps.extract_version.outputs.VERSION }}"
           TAG="${{ steps.extract_version.outputs.TAG }}"
-          RELEASE_URL="${{ github.event.release.html_url }}"
           
-          # 构建消息内容（仅包含关键信息）
-          MESSAGE="🔨 <b>Docker 镜像构建中</b>"$'\n'$'\n'"📦 <b>版本:</b> ${VERSION}"$'\n'"🏷️ <b>Tag:</b> <code>${TAG}</code>"$'\n'"🔗 <a href=\"${RELEASE_URL}\">查看 Release</a>"
+          if [ "${{ github.event_name }}" = "release" ]; then
+            RELEASE_URL="${{ github.event.release.html_url }}"
+            MESSAGE="🔨 <b>Release 构建中</b>"$'\n'$'\n'"🏷️ <b>Tag:</b> <code>${TAG}</code>"$'\n'"🔧 <b>构建类型:</b> Docker 升级"$'\n'"🔗 <a href=\"${RELEASE_URL}\">查看 Release</a>"
+          else
+            WORKFLOW_URL="https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+            MESSAGE="🔨 <b>构建中</b>"$'\n'$'\n'"🏷️ <b>Tag:</b> <code>${TAG}</code>"$'\n'"🔧 <b>构建类型:</b> Docker 升级"$'\n'"🔗 <a href=\"${WORKFLOW_URL}\">查看 Workflow</a>"
+          fi
           
           # 发送 Telegram 消息（使用 jq 转义 JSON）
           curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
@@ -141,12 +198,18 @@ jobs:
           echo "✅ 前端文件已复制"
           
           # 创建版本信息文件
+          if [ "${{ github.event_name }}" = "release" ]; then
+            RELEASE_NOTES=$(echo '${{ github.event.release.body }}' | jq -Rs .)
+          else
+            RELEASE_NOTES="\"手动构建 - workflow_dispatch\""
+          fi
+          
           cat > update-package/version.json <<EOF
           {
             "version": "${{ steps.extract_version.outputs.VERSION }}",
             "tag": "${{ steps.extract_version.outputs.TAG }}",
             "buildTime": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
-            "releaseNotes": $(echo '${{ github.event.release.body }}' | jq -Rs .)
+            "releaseNotes": ${RELEASE_NOTES}
           }
           EOF
           echo "✅ 版本信息已创建"
@@ -169,6 +232,7 @@ jobs:
           echo "$CHECKSUM  $FILE" > checksums.txt
       
       - name: Upload Update Package to Release
+        if: github.event_name == 'release'
         uses: actions/upload-release-asset@v1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -178,7 +242,8 @@ jobs:
           asset_name: polyhermes-${{ steps.extract_version.outputs.TAG }}-update.tar.gz
           asset_content_type: application/gzip
       
-      - name: Upload Checksums
+      - name: Upload Checksums to Release
+        if: github.event_name == 'release'
         uses: actions/upload-release-asset@v1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -188,19 +253,32 @@ jobs:
           asset_name: checksums.txt
           asset_content_type: text/plain
       
+      - name: Upload Update Package as Artifact
+        if: github.event_name == 'workflow_dispatch'
+        uses: actions/upload-artifact@v4
+        with:
+          name: polyhermes-${{ steps.extract_version.outputs.TAG }}-update
+          path: |
+            polyhermes-${{ steps.extract_version.outputs.TAG }}-update.tar.gz
+            checksums.txt
+          retention-days: 30
+      
       - name: Set up Docker Buildx
+        if: steps.build_config.outputs.BUILD_TYPE == 'package-and-docker'
         uses: docker/setup-buildx-action@v3
         with:
           # 启用多架构构建支持
           platforms: linux/amd64,linux/arm64
       
       - name: Log in to Docker Hub
+        if: steps.build_config.outputs.BUILD_TYPE == 'package-and-docker'
         uses: docker/login-action@v3
         with:
           username: ${{ secrets.DOCKER_USERNAME }}
           password: ${{ secrets.DOCKER_PASSWORD }}
       
       - name: Prepare Docker build context
+        if: steps.build_config.outputs.BUILD_TYPE == 'package-and-docker'
         run: |
           echo "📦 准备 Docker 构建上下文..."
           # 确保构建产物存在且可访问
@@ -217,6 +295,7 @@ jobs:
           ls -lh backend/build/libs/*.jar
       
       - name: Build and push Docker image
+        if: steps.build_config.outputs.BUILD_TYPE == 'package-and-docker'
         uses: docker/build-push-action@v5
         with:
           context: .
@@ -234,6 +313,12 @@ jobs:
             GITHUB_REPO_URL=https://github.com/WrBug/PolyHermes
           cache-from: type=registry,ref=wrbug/polyhermes:latest
           cache-to: type=inline
+      
+      - name: Skip Docker build notice
+        if: steps.build_config.outputs.BUILD_TYPE == 'package-only'
+        run: |
+          echo "⏭️  跳过 Docker 镜像构建（构建类型：package-only）"
+          echo "✅ 仅打包产物已完成"
 
       - name: Send Telegram notification
         if: steps.extract_version.outputs.IS_PRERELEASE == 'false'
@@ -250,13 +335,26 @@ jobs:
           # 获取构建信息
           VERSION="${{ steps.extract_version.outputs.VERSION }}"
           TAG="${{ steps.extract_version.outputs.TAG }}"
-          RELEASE_NAME="${{ github.event.release.name }}"
-          RELEASE_URL="${{ github.event.release.html_url }}"
-          REPO_NAME="${{ github.repository }}"
+          BUILD_TYPE="${{ steps.build_config.outputs.BUILD_TYPE }}"
           
           # 构建消息内容（仅包含关键信息）
           DEPLOY_DOC_URL="https://github.com/WrBug/PolyHermes/blob/main/docs/zh/DEPLOYMENT.md"
-          MESSAGE="✅ <b>Docker 镜像构建成功</b>"$'\n'$'\n'"📦 <b>版本:</b> ${VERSION}"$'\n'"🏷️ <b>Tag:</b> <code>${TAG}</code>"$'\n'"🔗 <a href=\"${RELEASE_URL}\">查看 Release</a>"$'\n'"📚 <a href=\"${DEPLOY_DOC_URL}\">Docker 部署文档</a>"
+          
+          if [ "${{ github.event_name }}" = "release" ]; then
+            RELEASE_URL="${{ github.event.release.html_url }}"
+            if [ "$BUILD_TYPE" = "package-and-docker" ]; then
+              MESSAGE="✅ <b>Release 构建成功</b>"$'\n'$'\n'"🏷️ <b>Tag:</b> <code>${TAG}</code>"$'\n'"🔧 <b>构建类型:</b> Docker 升级"$'\n'"🔗 <a href=\"${RELEASE_URL}\">查看 Release</a>"$'\n'"📚 <a href=\"${DEPLOY_DOC_URL}\">Docker 部署文档</a>"
+            else
+              MESSAGE="✅ <b>Release 打包成功</b>"$'\n'$'\n'"🏷️ <b>Tag:</b> <code>${TAG}</code>"$'\n'"🔧 <b>构建类型:</b> 在线升级"$'\n'"🔗 <a href=\"${RELEASE_URL}\">查看 Release</a>"$'\n'"📍 <b>升级路径:</b> 系统管理 → 概览 → 检查更新"
+            fi
+          else
+            WORKFLOW_URL="https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+            if [ "$BUILD_TYPE" = "package-and-docker" ]; then
+              MESSAGE="✅ <b>构建成功</b>"$'\n'$'\n'"🏷️ <b>Tag:</b> <code>${TAG}</code>"$'\n'"🔧 <b>构建类型:</b> Docker 升级"$'\n'"🔗 <a href=\"${WORKFLOW_URL}\">查看 Workflow</a>"$'\n'"📚 <a href=\"${DEPLOY_DOC_URL}\">Docker 部署文档</a>"
+            else
+              MESSAGE="✅ <b>打包成功</b>"$'\n'$'\n'"🏷️ <b>Tag:</b> <code>${TAG}</code>"$'\n'"🔧 <b>构建类型:</b> 在线升级"$'\n'"🔗 <a href=\"${WORKFLOW_URL}\">查看 Workflow</a>"$'\n'"📍 <b>升级路径:</b> 系统管理 → 概览 → 检查更新"
+            fi
+          fi
           
           # 发送 Telegram 消息（使用 jq 转义 JSON）
           curl -s -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \

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): 优化构建流程和通知机制
+
+---
+
+## 🙏 致谢
+
+感谢所有贡献者和用户的支持与反馈！
+

backend/src/main/kotlin/com/wrbug/polymarketbot/service/copytrading/orders/OrderSigningService.kt

@@ -94,14 +94,16 @@ class OrderSigningService {
         if (side.uppercase() == "BUY") {
             // BUY: makerAmount = price * size (USDC), takerAmount = size (shares)
             // 参考 clob-client/src/order-builder/helpers.ts 第 73-89 行
-            val rawTakerAmt = roundDown(sizeDecimal, roundConfig.size)
+            // 注意：Polymarket API 要求市场买入订单的 makerAmount 最多 2 位小数，takerAmount 最多 4 位小数
+            // takerAmount (shares) 使用 4 位小数
+            val rawTakerAmt = roundDown(sizeDecimal, 4)
 
             var rawMakerAmt = rawTakerAmt.multiply(rawPrice)
-            // 如果 makerAmount 的小数位数超过 roundConfig.amount，进行特殊舍入处理
-            if (decimalPlaces(rawMakerAmt) > roundConfig.amount) {
-                rawMakerAmt = roundUp(rawMakerAmt, roundConfig.amount + 4)
-                if (decimalPlaces(rawMakerAmt) > roundConfig.amount) {
-                    rawMakerAmt = roundDown(rawMakerAmt, roundConfig.amount)
+            // makerAmount (USDC) 使用 2 位小数
+            if (decimalPlaces(rawMakerAmt) > 2) {
+                rawMakerAmt = roundUp(rawMakerAmt, 2 + 4)
+                if (decimalPlaces(rawMakerAmt) > 2) {
+                    rawMakerAmt = roundDown(rawMakerAmt, 2)
                 }
             }