CI：移除自动部署，改为发布二进制到 Gitea Releases（v* tag 建版本号 Release，main push 更新 latest 预发布），README 记录发布流程

.gitea/workflows/ci.yml

@@ -2,7 +2,9 @@
 # FILE:  .gitea/workflows/ci.yml
 # DESC:  CI/CD for H100PowerManger
 #        - build/test on aarch64 (QEMU emulation of arm64 Ubuntu 20.04)
-#        - deploy the cross-built binary to the RK3588 board
+#        - publish compiled binary to Gitea Releases (manual deploy)
+#          * tag push v*  -> versioned Release
+#          * main push    -> rolling "latest" Release (pre-release / test)
 #        Self-contained (no external actions). The runner is an Alpine
 #        container with the host Docker socket mounted; we install the
 #        docker CLI at runtime.
@@ -40,7 +42,7 @@ jobs:
       #-------------------------------------------------------------------
       - name: Install tools
         run: |
-          apk add --no-cache docker-cli docker-cli-buildx rsync openssh-client
+          apk add --no-cache docker-cli docker-cli-buildx rsync openssh-client curl jq
 
       - name: Verify docker
         run: |
@@ -127,24 +129,92 @@ jobs:
           fi
 
       #-------------------------------------------------------------------
-      # Deploy the cross-built binary to the RK3588 board (push only)
+      # Publish the aarch64 binary to Gitea Releases (manual deployment)
+      #   * tag push (v*)   -> versioned Release (e.g. v1.0.0, stable)
+      #   * main push       -> rolling "latest" Release (pre-release/test)
+      # Only runs when build + tests succeeded.
       #-------------------------------------------------------------------
-      - name: Deploy to board
+      - name: Publish release
-        if: vars.DEPLOY_ENABLED == 'true'
+        if: success() && startsWith(github.ref, 'refs/tags/v')
         env:
-          DEPLOY_HOST: ${{ secrets.DEPLOY_HOST }}
+          RELEASE_TOKEN: ${{ secrets.CI_TOKEN }}
-          DEPLOY_USER: ${{ vars.DEPLOY_USER }}
-          DEPLOY_PATH: ${{ vars.DEPLOY_PATH }}
-          DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
         run: |
           set -euo pipefail
-          USER="${DEPLOY_USER:-root}"
+          REPO="${{ github.repository }}"
-          HOST="${DEPLOY_HOST:?DEPLOY_HOST secret not set}"
+          API="https://gitea2.zhaojingkui.xyz/api/v1/repos/${REPO}"
-          DEST="${DEPLOY_PATH:-/root/work/moos_ws/moos-ivp-extend/bin}"
+          TAG="${GITHUB_REF#refs/tags/}"
-          mkdir -p ~/.ssh && chmod 700 ~/.ssh
+          COMMIT_SHORT="$(git rev-parse --short HEAD)"
-          printf '%s\n' "$DEPLOY_SSH_KEY" > ~/.ssh/id_ed25519
+          REPORT_URL="https://gitea2.zhaojingkui.xyz/${REPO}/src/branch/test-reports/test-report.md"
-          chmod 600 ~/.ssh/id_ed25519
+          BODY="pPowerManger (aarch64 / RK3588 / Ubuntu 20.04)
-          ssh-keyscan -H "$HOST" >> ~/.ssh/known_hosts 2>/dev/null
+
-          chmod 755 bin/pPowerManger
+          - Commit: \`${COMMIT_SHORT}\`
-          rsync -avz bin/pPowerManger "${USER}@${HOST}:${DEST}/pPowerManger"
+          - 时间: $(date -u +'%Y-%m-%d %H:%M:%S UTC')
-          echo "Deployed pPowerManger -> ${USER}@${HOST}:${DEST}/"
+          - 测试报告: [${REPORT_URL}](${REPORT_URL})
+
+          手动部署: 下载后 scp/rsync 到板卡:
+          \`\`\`
+          rsync -avz pPowerManger root@192.168.0.223:/root/work/moos_ws/moos-ivp-extend/bin/pPowerManger
+          \`\`\`"
+
+          echo ">>> 创建版本号 Release: ${TAG}"
+          RELEASE_JSON=$(curl -sS -X POST -H "Authorization: token ${RELEASE_TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "{\"tag_name\":\"${TAG}\",\"name\":\"${TAG}\",\"body\":$(jq -Rn --arg b "${BODY}" '$b'),\"prerelease\":false}" \
+            "${API}/releases")
+          echo "${RELEASE_JSON}" | jq -e .id >/dev/null || { echo "创建 Release 失败:"; echo "${RELEASE_JSON}"; exit 1; }
+          RELEASE_ID=$(echo "${RELEASE_JSON}" | jq -r .id)
+          echo ">>> 上传 pPowerManger (release id=${RELEASE_ID})"
+          curl -sS -X POST -H "Authorization: token ${RELEASE_TOKEN}" \
+            -F "attachment=@bin/pPowerManger" \
+            "${API}/releases/${RELEASE_ID}/assets?name=pPowerManger" \
+            | jq -e .id >/dev/null || { echo "上传失败"; exit 1; }
+          echo ">>> 发布完成: https://gitea2.zhaojingkui.xyz/${REPO}/releases/tag/${TAG}"
+
+      - name: Publish latest release
+        if: success() && github.ref == 'refs/heads/main'
+        env:
+          RELEASE_TOKEN: ${{ secrets.CI_TOKEN }}
+        run: |
+          set -euo pipefail
+          REPO="${{ github.repository }}"
+          API="https://gitea2.zhaojingkui.xyz/api/v1/repos/${REPO}"
+          TAG="latest"
+          COMMIT_SHORT="$(git rev-parse --short HEAD)"
+          REPORT_URL="https://gitea2.zhaojingkui.xyz/${REPO}/src/branch/test-reports/test-report.md"
+          BODY="pPowerManger (aarch64 / RK3588 / Ubuntu 20.04) — 测试用最新构建
+
+          - Commit: \`${COMMIT_SHORT}\`
+          - 时间: $(date -u +'%Y-%m-%d %H:%M:%S UTC')
+          - 测试报告: [${REPORT_URL}](${REPORT_URL})
+
+          手动部署: 下载后 scp/rsync 到板卡:
+          \`\`\`
+          rsync -avz pPowerManger root@192.168.0.223:/root/work/moos_ws/moos-ivp-extend/bin/pPowerManger
+          \`\`\`"
+
+          # 1. move the "latest" tag to current commit
+          echo ">>> 移动 latest tag 到 ${COMMIT_SHORT}"
+          git tag -f "${TAG}" HEAD
+          git push -f origin "${TAG}" || true
+
+          # 2. delete old "latest" release (by tag), ignore if none
+          echo ">>> 删除旧的 latest Release (如有)"
+          curl -sS -X DELETE -H "Authorization: token ${RELEASE_TOKEN}" \
+            "${API}/releases/tags/${TAG}" || true
+
+          # 3. create new "latest" release (pre-release)
+          echo ">>> 创建 latest Release (pre-release)"
+          RELEASE_JSON=$(curl -sS -X POST -H "Authorization: token ${RELEASE_TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "{\"tag_name\":\"${TAG}\",\"name\":\"latest (测试)\",\"body\":$(jq -Rn --arg b "${BODY}" '$b'),\"prerelease\":true}" \
+            "${API}/releases")
+          echo "${RELEASE_JSON}" | jq -e .id >/dev/null || { echo "创建 latest Release 失败:"; echo "${RELEASE_JSON}"; exit 1; }
+          RELEASE_ID=$(echo "${RELEASE_JSON}" | jq -r .id)
+
+          # 4. upload pPowerManger
+          echo ">>> 上传 pPowerManger (release id=${RELEASE_ID})"
+          curl -sS -X POST -H "Authorization: token ${RELEASE_TOKEN}" \
+            -F "attachment=@bin/pPowerManger" \
+            "${API}/releases/${RELEASE_ID}/assets?name=pPowerManger" \
+            | jq -e .id >/dev/null || { echo "上传失败"; exit 1; }
+          echo ">>> 发布完成: https://gitea2.zhaojingkui.xyz/${REPO}/releases/tag/${TAG}"

README.md

@@ -10,3 +10,32 @@ H100 能源管理程序
 
 - [最新测试报告 (Markdown)](https://gitea2.zhaojingkui.xyz/zjk/H100PowerManger/src/branch/test-reports/test-report.md)
 - [JUnit XML](https://gitea2.zhaojingkui.xyz/zjk/H100PowerManger/raw/branch/test-reports/junit.xml)
+
+## 构建产物（Gitea Releases，手动部署）
+
+CI 构建的 aarch64 二进制（RK3588 / Ubuntu 20.04）会发布到 Gitea Releases，供手动下载部署：
+
+- **版本号 Release**：推送 `v*` tag（如 `v1.0.0`）时创建，正式版
+  → `https://gitea2.zhaojingkui.xyz/zjk/H100PowerManger/releases/tag/v1.0.0`
+- **latest Release（测试）**：每次 `main` push 时更新，标记为预发布（测试用）
+  → `https://gitea2.zhaojingkui.xyz/zjk/H100PowerManger/releases/tag/latest`
+
+### 发布流程（CI 自动执行，仅测试通过后发布）
+
+`Publish release` / `Publish latest release` 步骤（`if: success()`，即构建 + 测试全部通过才发布）用 `${{ secrets.CI_TOKEN }}` 调 Gitea API 完成：
+
+1. **创建 Release**：`POST /releases`
+2. **删除旧 latest**（仅 latest）：`DELETE /releases/tags/latest`
+3. **上传附件**：`POST /releases/{id}/assets?name=pPowerManger`（multipart 字段 `attachment`）
+4. **按 `github.ref` 分支处理**：
+   - `refs/tags/v*` → 直接为该 tag 创建版本号 Release
+   - `refs/heads/main` → `git tag -f latest && git push -f origin latest`，删除旧 latest Release，重建为 prerelease，再上传二进制
+5. **Release body** 自动带上：commit / 时间 / 测试报告链接 / 手动部署命令
+
+### 手动部署到板卡
+
+从 Releases 页面下载 `pPowerManger` 后，手动推送到板卡（仅推送，不自动重启）：
+
+```bash
+rsync -avz pPowerManger root@192.168.0.223:/root/work/moos_ws/moos-ivp-extend/bin/pPowerManger
+```