docs(index.ts): 完善语法检查配置的文档描述

ci(release.yml): 更新 CI 工作流配置和发布流程

更新语法检查插件的配置项文档描述，使其更清晰详细
升级 actions/checkout 到 v5 并更新 Node.js 版本至 22
优化发布流程，添加版本和标签存在性检查

Author: cklwblove

.github/workflows/release.yml

@@ -21,14 +21,14 @@ jobs:
 
     steps:
       - name: 检出代码
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
 
       - name: 设置 Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: 22
           registry-url: 'https://registry.npmjs.org'
 
       - name: 安装 pnpm
@@ -77,48 +77,50 @@ jobs:
       - name: 更新版本号 (手动触发时)
         if: github.event_name == 'workflow_dispatch'
         run: |
-          npm version ${{ steps.get_version.outputs.version }} --no-git-tag-version
-          git config --local user.email "action@github.com"
-          git config --local user.name "GitHub Action"
-          git add package.json
-          git commit -m "chore: bump version to ${{ steps.get_version.outputs.version }}"
-          git tag ${{ steps.get_version.outputs.tag_name }}
-          git push origin HEAD:${{ github.ref_name }}
-          git push origin ${{ steps.get_version.outputs.tag_name }}
+          # 检查 tag 是否已经存在
+          if git show-ref --tags --verify --quiet "refs/tags/${{ steps.get_version.outputs.tag_name }}"; then
+            echo "⚠️ Tag ${{ steps.get_version.outputs.tag_name }} 已存在，跳过创建"
+          else
+            npm version ${{ steps.get_version.outputs.version }} --no-git-tag-version
+            git config --local user.email "action@github.com"
+            git config --local user.name "GitHub Action"
+            git add package.json
+            git commit -m "chore: bump version to ${{ steps.get_version.outputs.version }}"
+            git tag ${{ steps.get_version.outputs.tag_name }}
+            git push origin HEAD:${{ github.ref_name }}
+            git push origin ${{ steps.get_version.outputs.tag_name }}
+          fi
 
       - name: 生成变更日志
         id: changelog
+        run: npx changelogithub
+        continue-on-error: true
+        env:
+          GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
+
+      - name: 发布到 npm
         run: |
-          # 获取上一个标签
-          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          # 检查版本是否已经发布到 npm
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
           
-          if [ -z "$PREV_TAG" ]; then
-            # 如果没有上一个标签，获取所有提交
-            CHANGELOG=$(git log --pretty=format:"- %s (%h)" --no-merges)
+          # 尝试获取 npm 上的版本信息
+          if npm view "${PACKAGE_NAME}@${CURRENT_VERSION}" version 2>/dev/null; then
+            echo "⚠️ 版本 ${CURRENT_VERSION} 已存在于 npm，跳过发布"
           else
-            # 获取两个标签之间的提交
-            CHANGELOG=$(git log ${PREV_TAG}..HEAD --pretty=format:"- %s (%h)" --no-merges)
+            echo "📦 发布版本 ${CURRENT_VERSION} 到 npm..."
+            pnpm publish --no-git-checks
           fi
-          
-          # 保存到文件以避免特殊字符问题
-          echo "$CHANGELOG" > changelog.txt
-          echo "changelog_file=changelog.txt" >> $GITHUB_OUTPUT
-
-      - name: 发布到 npm
-        run: pnpm publish --no-git-checks
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
-      - name: 创建 GitHub Release
-        uses: actions/create-release@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      - name: Create GitHub Release
+        uses: ncipollo/release-action@v1
         with:
-          tag_name: ${{ steps.get_version.outputs.tag_name }}
-          release_name: Release ${{ steps.get_version.outputs.tag_name }}
-          body_path: ${{ steps.changelog.outputs.changelog_file }}
-          draft: false
-          prerelease: false
+          generateReleaseNotes: "true"
+          allowUpdates: true
+          skipIfReleaseExists: false
+          omitBodyDuringUpdate: false
 
       - name: 通知发布成功
         run: |

src/index.ts

@@ -12,28 +12,49 @@ export default (api: IApi) => {
     key: 'checkSyntax',
     config: {
       schema({ zod }) {
-        return zod.union([
-          zod.boolean(),
-          zod.object({
-            /**
-             * The target browser range of the project.
-             * Its value is a standard browserslist array.
-             */
-            targets: zod.array(zod.string()).optional(),
-            /**
-             * Used to exclude a portion of source files during detection.
-             * You can pass in one or more regular expressions to match the paths of source files.
-             */
-            exclude: zod
-              .union([zod.string(), zod.array(zod.string())])
-              .optional(),
-            /**
-             * The minimum ECMAScript syntax version that can be used in the build artifact.
-             * The priority of `ecmaVersion` is higher than `targets`.
-             */
-            ecmaVersion: zod.union([zod.string(), zod.number()]).optional(),
-          }),
-        ]);
+        return zod
+          .union([
+            zod
+              .boolean()
+              .describe(
+                '是否启用语法检查。设为 true 启用默认配置的语法检查，false 禁用语法检查功能。',
+              ),
+            zod
+              .object({
+                targets: zod
+                  .array(zod.string())
+                  .describe(
+                    '目标浏览器兼容性范围配置。使用标准的 browserslist 格式数组，如 ["chrome >= 90", "firefox >= 88", "safari >= 14"]。插件将检查构建产物中的 JavaScript 语法是否与指定的浏览器兼容。如未配置，将使用项目根配置中的 targets 作为默认值。',
+                  )
+                  .optional(),
+                exclude: zod
+                  .union([zod.string(), zod.array(zod.string())])
+                  .describe(
+                    '排除语法检查的文件路径模式。支持单个正则表达式字符串或字符串数组，用于匹配需要跳过检查的源文件路径。例如："/node_modules/" 或 ["/vendor/", "\\.min\\.js$"]。被排除的文件不会进行语法兼容性检查。',
+                  )
+                  .optional(),
+                ecmaVersion: zod
+                  .union([
+                    zod
+                      .string()
+                      .regex(
+                        /^es(3|5|6|20\d{2}|\d+)$/i,
+                        'ECMAScript版本格式无效，支持格式：es3, es5, es6, es2015, es2016, es2017等',
+                      ),
+                    zod.number().min(3),
+                  ])
+                  .describe(
+                    '允许使用的最低 ECMAScript 语法版本。可以是字符串格式（如 "es5", "es2015", "es2020", "es2023"）或数字格式（如 5, 2015, 2020, 2023）。此配置的优先级高于 targets 配置。用于限制构建产物中可使用的 JavaScript 语法特性，确保代码在目标环境中正常运行。',
+                  )
+                  .optional(),
+              })
+              .describe(
+                '语法检查详细配置对象。用于自定义目标浏览器、排除文件和ECMAScript版本等检查参数。',
+              ),
+          ])
+          .describe(
+            '代码语法兼容性检查插件配置。基于 unplugin-check-syntax，在构建过程中检测 JavaScript/TypeScript 代码是否包含目标浏览器不支持的语法特性，支持 Vite、Webpack 和 Rspack 构建工具，帮助确保应用在指定浏览器环境中的兼容性。插件默认在非开发环境下启用。',
+          );
       },
     },
     enableBy: () => {