🔒 fix(ci): 修复 token 明文插值并加固脚本健壮性

- 安全: curl 的 Authorization 头改用 shell 变量 ${ACCESS_TOKEN}，
  避免 secret 经 ${{ }} 明文展开进脚本文本（changelog、stats）
- 修复: stats 分支清理 find 显式排除 .git，与注释一致，
  不再依赖 linked worktree 中 .git 为文件的隐含前提
- 健壮性: echo -e 前用 esc() 转义用户 message/body 中的反斜杠，
  防止字面 \n \t 被误展开破坏 Markdown
- 健壮性: 千分位格式化改用不依赖 locale 的 sed 实现，
  替换 printf "%'d"
- 健壮性: git log 的 range 变量补全引号
- 优化: prepare.yml 的 push 触发限定 main/master 分支与 tag，
  避免其它分支空跑
- 文档: route-release 标注 workflow_run.path 为 Gitea 特有字段

.gitea/workflows/changelog_and_release.yml

@@ -129,6 +129,9 @@ env:
 
 jobs:
   route-release:
+    # ⚠️ 依赖 Gitea 特有的 workflow_run.path 字段格式（形如 "<workflow>@refs/tags/<tag>"）
+    #    该字段非 GitHub Actions 标准，若 Gitea 升级改变其格式，发布会静默不触发。
+    #    已在 Gitea 1.22 上验证；升级后请复核此判据，必要时增加 fallback。
     if: ${{ github.event.workflow_run.conclusion == 'success' && contains(github.event.workflow_run.path, '@refs/tags/') }}
     runs-on: standard-ubuntu-22
     permissions:
@@ -526,7 +529,7 @@ jobs:
           echo "🔍 扫描提交记录..."
 
           TEMP_COMMITS=$(mktemp)
-          git log $COMMIT_RANGE --no-merges --reverse --format="COMMIT_START%n%H%n%an%n%s%nBODY_START%n%b%nBODY_END" > "$TEMP_COMMITS"
+          git log "$COMMIT_RANGE" --no-merges --reverse --format="COMMIT_START%n%H%n%an%n%s%nBODY_START%n%b%nBODY_END" > "$TEMP_COMMITS"
 
           declare -a COMMITS_HASH
           declare -a COMMITS_AUTHOR
@@ -647,6 +650,10 @@ jobs:
           REPO_URL="${{ github.server_url }}/${{ github.repository }}"
 
           # 初始化条目内容
+          # 转义用户内容中的反斜杠，避免后续 echo -e 误展开 message/body 里的
+          # 字面 \n \t \\ 等序列（我们自己插入的 \n 分隔符不经过此函数，仍正常换行）
+          esc() { printf '%s' "$1" | sed 's/\\/\\\\/g'; }
+
           NEW_ENTRY="## :bookmark: ${CHANGELOG_VERSION}\n\n"
           NEW_ENTRY="${NEW_ENTRY}${CHANGELOG_SECTION_TITLE}\n\n"
 
@@ -654,10 +661,10 @@ jobs:
           for ((i=0; i<$VALID_COUNT; i++)); do
             hash="${COMMITS_HASH[$i]}"
             author="${COMMITS_AUTHOR[$i]}"
-            message="${COMMITS_MESSAGE[$i]}"
+            message=$(esc "${COMMITS_MESSAGE[$i]}")
             body="${COMMITS_BODY[$i]}"
 
-            echo "  [$((i+1))/$VALID_COUNT] ${hash:0:7}: ${message:0:60}..."
+            echo "  [$((i+1))/$VALID_COUNT] ${hash:0:7}: ${COMMITS_MESSAGE[$i]:0:60}..."
 
             # 构建提交链接 - 使用短 hash 格式
             short_hash="${hash:0:7}"
@@ -671,8 +678,9 @@ jobs:
 
             # 处理 body (如果存在)
             if [ -n "$body" ]; then
-              # 移除首尾空行
+              # 移除首尾空行，并转义反斜杠
               cleaned_body=$(echo "$body" | sed -e :a -e '/^\s*$/d;')
+              cleaned_body=$(esc "$cleaned_body")
 
               if [ -n "$cleaned_body" ]; then
                 # 有 body: 主题在第一行，body 内容缩进显示，链接和作者放在一起
@@ -709,7 +717,7 @@ jobs:
               grep -vxF "${{ env.GIT_USER_NAME }}" | \
               sort -u)
           else
-            CONTRIBUTORS=$(git log $COMMIT_RANGE --pretty=format:"%an" --no-merges | \
+            CONTRIBUTORS=$(git log "$COMMIT_RANGE" --pretty=format:"%an" --no-merges | \
               grep -v "github-actions\[bot\]" | \
               grep -v "dependabot\[bot\]" | \
               grep -v "renovate\[bot\]" | \
@@ -782,7 +790,7 @@ jobs:
 
                 # 这是一个新的 commit，添加它
                 author="${COMMITS_AUTHOR[$i]}"
-                message="${COMMITS_MESSAGE[$i]}"
+                message=$(esc "${COMMITS_MESSAGE[$i]}")
                 body="${COMMITS_BODY[$i]}"
 
                 COMMIT_LINK="([${short_hash}](${REPO_URL}/commit/${hash}))"
@@ -795,6 +803,7 @@ jobs:
 
                 if [ -n "$body" ]; then
                   cleaned_body=$(echo "$body" | sed -e :a -e '/^\s*$/d;')
+                  cleaned_body=$(esc "$cleaned_body")
                   if [ -n "$cleaned_body" ]; then
                     NEW_COMMIT_ENTRIES="${NEW_COMMIT_ENTRIES}- ${message}  \n"
                     while IFS= read -r line; do
@@ -962,7 +971,7 @@ jobs:
           echo "📊 增量范围: $RELEASE_NOTES_RANGE"
 
           TEMP_COMMITS=$(mktemp)
-          git log $RELEASE_NOTES_RANGE --no-merges --reverse \
+          git log "$RELEASE_NOTES_RANGE" --no-merges --reverse \
             --format="COMMIT_START%n%H%n%an%n%s%nBODY_START%n%b%nBODY_END" > "$TEMP_COMMITS"
 
           declare -a COMMITS_HASH
@@ -1029,11 +1038,14 @@ jobs:
           VALID_COUNT=$COMMIT_INDEX
           echo "✅ 增量有效提交: $VALID_COUNT"
 
+          # 转义用户内容中的反斜杠，避免后续 echo -e 误展开 message/body 里的字面序列
+          esc() { printf '%s' "$1" | sed 's/\\/\\\\/g'; }
+
           NOTES="${CHANGELOG_SECTION_TITLE}\n\n"
           for ((i=0; i<$VALID_COUNT; i++)); do
             hash="${COMMITS_HASH[$i]}"
             author="${COMMITS_AUTHOR[$i]}"
-            message="${COMMITS_MESSAGE[$i]}"
+            message=$(esc "${COMMITS_MESSAGE[$i]}")
             body="${COMMITS_BODY[$i]}"
             short_hash="${hash:0:7}"
             COMMIT_LINK="([${short_hash}](${REPO_URL}/commit/${hash}))"
@@ -1042,6 +1054,7 @@ jobs:
 
             if [ -n "$body" ]; then
               cleaned_body=$(echo "$body" | sed -e :a -e '/^\s*$/d;')
+              cleaned_body=$(esc "$cleaned_body")
             else
               cleaned_body=""
             fi
@@ -1062,7 +1075,7 @@ jobs:
           if [ "$RELEASE_NOTES_RANGE" = "HEAD" ]; then
             CONTRIBUTORS=$(git log --pretty=format:"%an" --no-merges)
           else
-            CONTRIBUTORS=$(git log $RELEASE_NOTES_RANGE --pretty=format:"%an" --no-merges)
+            CONTRIBUTORS=$(git log "$RELEASE_NOTES_RANGE" --pretty=format:"%an" --no-merges)
           fi
           CONTRIBUTORS=$(echo "$CONTRIBUTORS" | \
             grep -v "github-actions\[bot\]" | \
@@ -1126,7 +1139,7 @@ jobs:
 
           echo "🌐 发送 API 请求..."
           HTTP_CODE=$(curl -s -o /tmp/release_response.json -w "%{http_code}" -X POST \
-            -H "Authorization: token ${{ env.ACCESS_TOKEN }}" \
+            -H "Authorization: token ${ACCESS_TOKEN}" \
             -H "Content-Type: application/json" \
             -d @/tmp/payload.json \
             "${{ github.server_url }}/api/v1/repos/${{ github.repository }}/releases")
@@ -1192,7 +1205,7 @@ jobs:
               if [ -f "$file" ]; then
                 echo "📤 [$FILE_INDEX/$TOTAL_FILES] 上传 $(basename $file)..."
                 HTTP_CODE=$(curl -s -o /tmp/upload_response_${FILE_INDEX}.json -w "%{http_code}" -X POST \
-                  -H "Authorization: token ${{ env.ACCESS_TOKEN }}" \
+                  -H "Authorization: token ${ACCESS_TOKEN}" \
                   -F "attachment=@${file}" \
                   "${{ github.server_url }}/api/v1/repos/${{ github.repository }}/releases/$RELEASE_ID/assets?name=$(basename $file)")
 

.gitea/workflows/prepare.yml

@@ -2,6 +2,14 @@ name: 🧰 准备环境
 
 on:
   push:
+    # 仅在主分支和 tag 上触发。
+    # 下游 stats 只在 main/master 运行、changelog 只在 tag 运行，
+    # 其它分支（含 ci bot 推送的 stats 分支）跑 Prepare 纯属空耗，故在此过滤。
+    branches:
+      - main
+      - master
+    tags:
+      - "**"
   workflow_dispatch:
 
 concurrency:

.gitea/workflows/update_stats_badge.yml

@@ -85,7 +85,7 @@ jobs:
         run: |
           echo "🔐 验证访问令牌..."
 
-          if [ -z "${{ env.ACCESS_TOKEN }}" ]; then
+          if [ -z "$ACCESS_TOKEN" ]; then
             echo "❌ 错误: 未配置访问令牌"
             echo "请在 Settings -> Secrets 中配置 WORKFLOW secret"
             exit 1
@@ -230,7 +230,7 @@ jobs:
           # 使用更严格的保护，确保不会误删 .git
           echo "🔍 查找需要删除的文件..."
           find . -maxdepth 1 -type f ! -name '.git' ! -name '.gitignore' -delete 2>/dev/null || true
-          find . -maxdepth 1 -type d ! -name '.' ! -name '..' ! -name '.gitea' -exec rm -rf {} + 2>/dev/null || true
+          find . -maxdepth 1 -type d ! -name '.' ! -name '..' ! -name '.git' ! -name '.gitea' -exec rm -rf {} + 2>/dev/null || true
 
           # 🔴 最终检查：确认 .git 仍然完好
           echo "🔍 最终检查..."
@@ -331,8 +331,10 @@ jobs:
           echo "  - 总代码行: $TOTAL_CODE"
 
           # 格式化数字（添加千分位）
-          FORMATTED_FILES=$(printf "%'d" $TOTAL_FILES)
+          # 用 sed 手工加千分位，避免依赖 locale（printf "%'d" 在 C/POSIX locale 下失效）
-          FORMATTED_CODE=$(printf "%'d" $TOTAL_CODE)
+          add_thousands() { printf '%s' "$1" | sed -E ':a;s/([0-9])([0-9]{3})($|[^0-9])/\1,\2\3/;ta'; }
+          FORMATTED_FILES=$(add_thousands "$TOTAL_FILES")
+          FORMATTED_CODE=$(add_thousands "$TOTAL_CODE")
 
           # 输出到环境变量
           echo "total_files=$TOTAL_FILES" >> $GITHUB_OUTPUT
@@ -361,6 +363,9 @@ jobs:
           # 创建临时目录
           mkdir -p /tmp/lang_stats
 
+          # 用 sed 手工加千分位，避免依赖 locale（printf "%'d" 在 C/POSIX locale 下失效）
+          add_thousands() { printf '%s' "$1" | sed -E ':a;s/([0-9])([0-9]{3})($|[^0-9])/\1,\2\3/;ta'; }
+
           # 构建排除参数
           EXCLUDE_FIND_ARGS=()
           IFS=',' read -ra EXCLUDES <<< "${{ env.EXCLUDE_DIRS }}"
@@ -399,7 +404,7 @@ jobs:
 
               # 只保存超过阈值的语言
               if [ "$CODE_LINES" -ge "${{ env.MIN_LINES_THRESHOLD }}" ]; then
-                FORMATTED_LINES=$(printf "%'d" $CODE_LINES)
+                FORMATTED_LINES=$(add_thousands "$CODE_LINES")
 
                 echo "  - 文件数: $FILE_COUNT"
                 echo "  - 代码行: $FORMATTED_LINES"

CHANGELOG.md

@@ -57,6 +57,16 @@
   改用不依赖区间的等价写法，并清理 0.0.5 段已产生的重复内容。  
   ([207588a](https://git.mytsl.cn/csh/actions-template/commit/207588ae369d045c1ec3178ce4f6969b3b499981)) by @csh
 
+
+- :sparkles: feat(ci): Release Notes 改为增量展示，正式版覆盖整个版本周期  
+  CHANGELOG.md 仍保持整个版本累积（strip 模式），但 Release Notes 改为：  
+  - 预发布(rc)：只展示相对紧邻上一个 tag 的增量（如 rc1→rc2 新提交），  
+    避免同版本各 rc 之间大量重复。  
+  - 正式版：跳过同版本 rc，基准落到上一个不同版本 tag，  
+    覆盖整个版本开发周期的全量提交。  
+  基准 tag 按 RELEASE_IS_PRERELEASE 区分，Release Notes 独立用 git log 重新生成。  
+  ([3054338](https://git.mytsl.cn/csh/actions-template/commit/3054338cf75796d3c77d90c26a41641150154fde)) by @csh
+
 ### :busts_in_silhouette: Contributors
 
 <a href="https://git.mytsl.cn/csh">