diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
index 6c4a433..1611048 100644
--- a/.gitea/workflows/ci.yml
+++ b/.gitea/workflows/ci.yml
@@ -7,7 +7,8 @@
 #   develop     → :develop +  :sha-<短提交号>
 #
 # 前置配置（Gitea → 仓库 → 设置 → Secrets）：
-#   GITEA_TOKEN — 具有 package:write 权限的 Gitea Access Token
+#   REGISTRY_TOKEN — 具有 package:write 权限的 Gitea Access Token
+#   （注意：Gitea 禁止使用 GITEA_ / GITHUB_ 前缀的 Secret 名称）
 # ═══════════════════════════════════════════════════════════════
 
 name: CI — Docker Build & Push
@@ -58,7 +59,7 @@ jobs:
         with:
           registry: ${{ env.REGISTRY }}
           username: ${{ gitea.actor }}
-          password: ${{ secrets.GITEA_TOKEN }}
+          password: ${{ secrets.REGISTRY_TOKEN }}
 
       # ── 6. 提取镜像元数据（自动生成 tags 和 labels）─────────
       - name: 提取镜像元数据
diff --git a/.gitea/workflows/release.yml b/.gitea/workflows/release.yml
index cf6b151..16aa863 100644
--- a/.gitea/workflows/release.yml
+++ b/.gitea/workflows/release.yml
@@ -6,7 +6,8 @@
 #   v1.2.3 → :1.2.3  +  :1.2  +  :1  +  :latest
 #
 # 前置配置（Gitea → 仓库 → 设置 → Secrets）：
-#   GITEA_TOKEN — 具有 package:write 权限的 Gitea Access Token
+#   REGISTRY_TOKEN — 具有 package:write 权限的 Gitea Access Token
+#   （注意：Gitea 禁止使用 GITEA_ / GITHUB_ 前缀的 Secret 名称）
 # ═══════════════════════════════════════════════════════════════
 
 name: Release — Docker Build & Push
@@ -62,7 +63,7 @@ jobs:
         with:
           registry: ${{ env.REGISTRY }}
           username: ${{ gitea.actor }}
-          password: ${{ secrets.GITEA_TOKEN }}
+          password: ${{ secrets.REGISTRY_TOKEN }}
 
       # ── 6. 提取镜像元数据 ────────────────────────────────────
       # metadata-action 对 semver tag 会自动生成多级标签：