chore: docker policy changed

Author: Charliechen114514

.github/workflows/docker-publish.yml

@@ -24,18 +24,48 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check Docker publish policy
+        id: policy
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          should_publish="true"
+          reason="manual dispatch or no opt-out marker"
+
+          if [[ "${GITHUB_EVENT_NAME}" == "push" && "${GITHUB_REF_TYPE}" == "tag" ]]; then
+            tag_message="$(git for-each-ref "refs/tags/${GITHUB_REF_NAME}" --format='%(contents)' || true)"
+            if printf '%s\n' "${tag_message}" | grep -qiE '^Docker-Image:[[:space:]]*false[[:space:]]*$'; then
+              should_publish="false"
+              reason="tag ${GITHUB_REF_NAME} has Docker-Image: false"
+            fi
+          fi
+
+          echo "should_publish=${should_publish}" >> "${GITHUB_OUTPUT}"
+          {
+            echo "## Docker Publish Policy"
+            echo ""
+            echo "- Should publish: \`${should_publish}\`"
+            echo "- Reason: ${reason}"
+          } >> "${GITHUB_STEP_SUMMARY}"
 
       - name: Set up Docker Buildx
+        if: steps.policy.outputs.should_publish == 'true'
         uses: docker/setup-buildx-action@v3
 
       - name: Log in to GitHub Container Registry
+        if: steps.policy.outputs.should_publish == 'true'
         uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
           password: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Extract metadata
+        if: steps.policy.outputs.should_publish == 'true'
         id: meta
         uses: docker/metadata-action@v5
         with:
@@ -48,6 +78,7 @@ jobs:
             type=raw,value=${{ github.event.inputs.tag }},enable=${{ github.event_name == 'workflow_dispatch' }}
 
       - name: Build and push
+        if: steps.policy.outputs.should_publish == 'true'
         uses: docker/build-push-action@v5
         with:
           context: docker

.github/workflows/release.yml

@@ -19,6 +19,11 @@ on:
       create_github_release:
         description: 'Create a GitHub Release'
         required: true
+        default: false
+        type: boolean
+      publish_docker_image:
+        description: 'Publish Docker image for this version'
+        required: true
         default: true
         type: boolean
       dry_run:
@@ -140,6 +145,8 @@ jobs:
             echo "- Latest stable tag: \`${latest_tag}\`"
             echo "- New version: \`${new_version}\`"
             echo "- Release type: \`${RELEASE_TYPE}\`"
+            echo "- Create GitHub Release: \`${{ inputs.create_github_release }}\`"
+            echo "- Publish Docker image: \`${{ inputs.publish_docker_image }}\`"
             echo "- Release document: \`${release_doc_status}\`"
           } >> "${GITHUB_STEP_SUMMARY}"
 
@@ -215,6 +222,8 @@ jobs:
             echo ""
             echo "- Previous tag: ${LATEST_TAG}"
             echo "- New tag: ${NEW_VERSION}"
+            echo "- GitHub Release: ${{ inputs.create_github_release }}"
+            echo "- Docker image: ${{ inputs.publish_docker_image }}"
           } > release-body.md
 
           echo "body_file=release-body.md" >> "${GITHUB_OUTPUT}"
@@ -227,6 +236,9 @@ jobs:
         shell: bash
         env:
           NEW_VERSION: ${{ steps.version.outputs.new_version }}
+          RELEASE_TYPE: ${{ inputs.release_type }}
+          CREATE_GITHUB_RELEASE: ${{ inputs.create_github_release }}
+          PUBLISH_DOCKER_IMAGE: ${{ inputs.publish_docker_image }}
         run: |
           set -euo pipefail
 
@@ -239,7 +251,15 @@ jobs:
             exit 1
           fi
 
-          git tag -a "${NEW_VERSION}" -m "IMX-Forge ${NEW_VERSION}"
+          {
+            echo "IMX-Forge ${NEW_VERSION}"
+            echo ""
+            echo "Release-Type: ${RELEASE_TYPE}"
+            echo "GitHub-Release: ${CREATE_GITHUB_RELEASE}"
+            echo "Docker-Image: ${PUBLISH_DOCKER_IMAGE}"
+          } > tag-message.txt
+
+          git tag -a "${NEW_VERSION}" -F tag-message.txt
           git push origin "refs/tags/${NEW_VERSION}"
 
       - name: Create GitHub Release

document/release/versioning-strategy.md

@@ -16,7 +16,7 @@ IMX-Forge 目前更适合采用 **维护者手动触发 release workflow** 的
 - PR 只承担代码和文档变更，不承担版本号决策。
 - 版本号不是单个 PR 的属性，而是维护者对一批变更形成稳定发布点后的判断。
 - 是否发布、发布为 PATCH / MINOR / MAJOR，由维护者在触发 workflow 时决定。
-- workflow 负责执行机械动作：计算版本号、打 tag、创建 GitHub Release、触发 Docker 发布。
+- workflow 负责执行机械动作：计算版本号、打 tag，并按维护者选择创建 GitHub Release、触发 Docker 发布。
 
 这样可以避免小修小补频繁发布 PATCH，也保留 CI 自动化带来的可重复性和低出错率。
 
@@ -32,7 +32,7 @@ IMX-Forge 目前更适合采用 **维护者手动触发 release workflow** 的
 | Release 文档 | `document/release/v1.0.0.md` | 适合继续按正式版本维护 |
 | CHANGELOG | `changelog/CHANGELOG.md` | 已存在，后续沿用此路径 |
 | GitHub Actions workflow | 5 个 | 已有 CI、Full Build、Pages、Docker 发布基础 |
-| Docker 发布触发 | `v*.*.*` tag | 与手动 release workflow 天然衔接 |
+| Docker 发布触发 | `v*.*.*` tag + tag message 策略 | 与手动 release workflow 衔接，并支持按版本跳过 |
 | `package.json` version | `0.0.1` 且 `private: true` | 不作为项目发布版本源 |
 
 现有 workflow：
@@ -43,7 +43,7 @@ IMX-Forge 目前更适合采用 **维护者手动触发 release workflow** 的
 - `.github/workflows/deploy.yml`
 - `.github/workflows/docker-publish.yml`
 
-关键点：`.github/workflows/docker-publish.yml` 已经在 `v*.*.*` tag push 时发布 Docker 镜像。因此 release workflow 只要推送正式 tag，就能自然触发 Docker 发布。
+关键点：`.github/workflows/docker-publish.yml` 已经在 `v*.*.*` tag push 时响应 Docker 发布。release workflow 会在 annotated tag message 中写入 `Docker-Image: true/false`，Docker workflow 据此决定是否实际构建镜像。
 
 ---
 
@@ -160,7 +160,8 @@ MAJOR 只用于不兼容变化。
 |---|---|---|
 | `release_type` | `patch` / `minor` / `major` | 必填，决定版本号升级段 |
 | `version_override` | string | 可选，手动指定版本号；为空时自动计算 |
-| `create_github_release` | boolean | 默认 `true`，是否创建 GitHub Release |
+| `create_github_release` | boolean | 默认 `false`，是否创建 GitHub Release |
+| `publish_docker_image` | boolean | 默认 `true`，是否发布 Docker 镜像 |
 | `dry_run` | boolean | 默认 `true`，仅计算和预览，不推送 tag |
 
 正式发布示例：
@@ -186,14 +187,18 @@ release workflow 应执行以下动作：
   |-- 运行必要发布前检查
   |-- 创建 annotated tag
   |-- push tag
-  |-- 创建 GitHub Release
-  |-- 由 docker-publish.yml 自动响应 tag 并发布 Docker 镜像
+  |-- 按 create_github_release 决定是否创建 GitHub Release
+  |-- 按 publish_docker_image 决定 docker-publish.yml 是否发布 Docker 镜像
 ```
 
-建议 tag 使用 annotated tag：
+建议 tag 使用 annotated tag，并写入发布意图：
 
-```bash
-git tag -a "v1.1.0" -m "IMX-Forge v1.1.0"
+```text
+IMX-Forge v1.1.0
+
+Release-Type: minor
+GitHub-Release: true
+Docker-Image: true
 ```
 
 ### 5.4 发布前检查
@@ -216,7 +221,7 @@ Full Build 是否放进 release workflow 可按阶段决定。当前建议：
 
 ## 6. GitHub Release 策略
 
-正式 tag 默认创建 GitHub Release。
+正式 tag 默认不创建 GitHub Release。维护者只在该版本值得公告时开启 `create_github_release`。
 
 建议：
 
@@ -275,7 +280,7 @@ IMX-Forge vX.Y.Z
 [![License](https://img.shields.io/badge/License-MIT-orange?style=flat-square)](LICENSE)
 ```
 
-由于正式 tag 默认创建 GitHub Release，README badge 与 Docker tag、GitHub Release 不会出现明显版本分裂。
+由于 GitHub Release 与 Docker 镜像发布已经解耦，README badge 展示的是最新 GitHub Release，不一定等于最新 git tag 或 Docker 镜像版本。这是有意设计：Release 用于公告稳定节点，Docker 镜像可按需更频繁更新。
 
 ---
 
@@ -381,11 +386,11 @@ v1.1.0
 
 | # | 项目 | 类型 | 说明 |
 |---|---|---|---|
-| 1 | `.github/workflows/release.yml` | 新增 | 手动触发 release，计算版本号、打 tag、创建 Release |
+| 1 | `.github/workflows/release.yml` | 新增 | 手动触发 release，计算版本号、打 tag，并按选项创建 Release / 发布 Docker |
 | 2 | `README.md` | 修改 | 在 badge 区域增加 Release badge |
 | 3 | `changelog/CHANGELOG.md` | 修改 | 保持现有路径，后续按版本补充 |
 | 4 | `document/release/versioning-strategy.md` | 修改 | 本策略文档，已接入发布文档站 |
-| 5 | `.github/workflows/docker-publish.yml` | 复用 | 继续由 `v*.*.*` tag 自动触发 Docker 发布 |
+| 5 | `.github/workflows/docker-publish.yml` | 修改 | 继续响应 `v*.*.*` tag，并按 tag message 中的 `Docker-Image` 决定是否发布 |
 
 暂不实施：