fix: docker issue

Author: Charliechen114514

.github/workflows/docker-publish.yml

@@ -6,14 +6,11 @@ on:
       - 'v*.*.*'
   workflow_dispatch:
     inputs:
-      tag:
-        description: 'Image tag to build'
-        required: true
-        default: 'latest'
-        type: choice
-        options:
-          - latest
-          - preview
+      extra_tag:
+        description: 'Optional extra image tag, for example latest or preview'
+        required: false
+        default: ''
+        type: string
 
 permissions:
   contents: read
@@ -75,7 +72,7 @@ jobs:
             type=semver,pattern={{version}}
             type=semver,pattern={{major}}.{{minor}}
             type=semver,pattern={{major}}
-            type=raw,value=${{ github.event.inputs.tag }},enable=${{ github.event_name == 'workflow_dispatch' }}
+            type=raw,value=${{ github.event.inputs.extra_tag }},enable=${{ github.event_name == 'workflow_dispatch' && github.event.inputs.extra_tag != '' }}
 
       - name: Build and push
         if: steps.policy.outputs.should_publish == 'true'

.github/workflows/release.yml

@@ -33,6 +33,7 @@ on:
         type: boolean
 
 permissions:
+  actions: write
   contents: write
 
 concurrency:
@@ -272,6 +273,14 @@ jobs:
             --title "IMX-Forge ${NEW_VERSION}" \
             --notes-file release-body.md
 
+      - name: Dispatch Docker publish
+        if: ${{ !inputs.dry_run && inputs.publish_docker_image }}
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NEW_VERSION: ${{ steps.version.outputs.new_version }}
+        run: |
+          gh workflow run docker-publish.yml --ref "${NEW_VERSION}"
+
       - name: Dry run notice
         if: ${{ inputs.dry_run }}
         run: echo "Dry run enabled. No tag or GitHub Release was created."

document/release/versioning-strategy.md

@@ -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 + tag message 策略 | 与手动 release workflow 衔接，并支持按版本跳过 |
+| Docker 发布触发 | release workflow dispatch + 手动 dispatch + tag push 兜底 | 与手动 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 会在 annotated tag message 中写入 `Docker-Image: true/false`，Docker workflow 据此决定是否实际构建镜像。
+关键点：GitHub Actions 使用 `GITHUB_TOKEN` 推送 tag 时，不会级联触发另一个 `push tags` workflow。release workflow 因此在 `publish_docker_image=true` 时显式 `workflow_dispatch` 调用 `.github/workflows/docker-publish.yml`，并以新 tag 作为 `--ref`。本地或人工推送 `v*.*.*` tag 时，Docker workflow 仍可通过 tag push 触发作为兜底。
 
 ---
 
@@ -188,7 +188,7 @@ release workflow 应执行以下动作：
   |-- 创建 annotated tag
   |-- push tag
   |-- 按 create_github_release 决定是否创建 GitHub Release
-  |-- 按 publish_docker_image 决定 docker-publish.yml 是否发布 Docker 镜像
+  |-- 按 publish_docker_image 决定是否显式 dispatch docker-publish.yml
 ```
 
 建议 tag 使用 annotated tag，并写入发布意图：
@@ -201,6 +201,8 @@ GitHub-Release: true
 Docker-Image: true
 ```
 
+注意：`Docker-Image` 字段主要用于人工 tag push 的兜底路径。release workflow 创建 tag 后，会直接通过 `workflow_dispatch` 触发 Docker workflow，避免 `GITHUB_TOKEN` tag push 不触发后续 workflow 的限制。
+
 ### 5.4 发布前检查
 
 发布 workflow 至少应执行：
@@ -390,7 +392,7 @@ v1.1.0
 | 2 | `README.md` | 修改 | 在 badge 区域增加 Release badge |
 | 3 | `changelog/CHANGELOG.md` | 修改 | 保持现有路径，后续按版本补充 |
 | 4 | `document/release/versioning-strategy.md` | 修改 | 本策略文档，已接入发布文档站 |
-| 5 | `.github/workflows/docker-publish.yml` | 修改 | 继续响应 `v*.*.*` tag，并按 tag message 中的 `Docker-Image` 决定是否发布 |
+| 5 | `.github/workflows/docker-publish.yml` | 修改 | 支持 release workflow dispatch，在 tag push 兜底路径中按 tag message 的 `Docker-Image` 决定是否发布 |
 
 暂不实施：