Refactor GitHub tag fetching and mirror management

Replaces legacy tag fetching logic in napcat-common with a new mirror.ts module that centralizes GitHub mirror configuration, selection, and tag retrieval. Updates helper.ts to use the new mirror system and semver comparison, and exports compareSemVer for broader use. Updates workflows and scripts to generate and propagate build version information, and improves build status comment formatting for PRs. Also updates release workflow to use a new OpenAI key and model.

.github/scripts/lib/comment.ts

@@ -24,6 +24,10 @@ function escapeCodeBlock (text: string): string {
   return text.replace(/```/g, '\\`\\`\\`');
 }
 
+function getTimeString (): string {
+  return new Date().toISOString().replace('T', ' ').substring(0, 19) + ' UTC';
+}
+
 // ============== 状态图标 ==============
 
 export function getStatusIcon (status: BuildStatus): string {
@@ -34,30 +38,66 @@ export function getStatusIcon (status: BuildStatus): string {
       return '⏳ 构建中...';
     case 'cancelled':
       return '⚪ 已取消';
-    default:
+    case 'failure':
       return '❌ 失败';
+    default:
+      return '❓ 未知';
+  }
+}
+
+function getStatusEmoji (status: BuildStatus): string {
+  switch (status) {
+    case 'success': return '✅';
+    case 'pending': return '⏳';
+    case 'cancelled': return '⚪';
+    case 'failure': return '❌';
+    default: return '❓';
   }
 }
 
 // ============== 构建中评论 ==============
 
 export function generateBuildingComment (prSha: string, targets: string[]): string {
-  const time = new Date().toISOString().replace('T', ' ').substring(0, 19) + ' UTC';
+  const time = getTimeString();
+  const shortSha = formatSha(prSha);
 
   const lines: string[] = [
     COMMENT_MARKER,
-    '## 🔨 构建状态',
     '',
-    '| 构建目标 | 状态 |',
-    '| :--- | :--- |',
-    ...targets.map(name => `| ${name} | ⏳ 构建中... |`),
+    '<div align="center">',
+    '',
+    '# 🔨 NapCat 构建中',
+    '',
+    '![Building](https://img.shields.io/badge/状态-构建中-yellow?style=for-the-badge&logo=github-actions&logoColor=white)',
+    '',
+    '</div>',
     '',
     '---',
     '',
-    `📝 **提交**: \`${formatSha(prSha)}\``,
-    `🕐 **开始时间**: ${time}`,
+    '## 📦 构建目标',
     '',
-    '> 构建进行中，请稍候...',
+    '| 包名 | 状态 | 说明 |',
+    '| :--- | :---: | :--- |',
+    ...targets.map(name => `| \`${name}\` | ⏳ | 正在构建... |`),
+    '',
+    '---',
+    '',
+    '## 📋 构建信息',
+    '',
+    `| 项目 | 值 |`,
+    `| :--- | :--- |`,
+    `| 📝 提交 | \`${shortSha}\` |`,
+    `| 🕐 开始时间 | ${time} |`,
+    '',
+    '---',
+    '',
+    '<div align="center">',
+    '',
+    '> ⏳ **构建进行中，请稍候...**',
+    '>',
+    '> 构建完成后将自动更新此评论',
+    '',
+    '</div>',
   ];
 
   return lines.join('\n');
@@ -69,60 +109,123 @@ export function generateResultComment (
   targets: BuildTarget[],
   prSha: string,
   runId: string,
-  repository: string
+  repository: string,
+  version?: string
 ): string {
-  // 链接到 run 详情页，页面底部有 Artifacts 下载区域
   const runUrl = `https://github.com/${repository}/actions/runs/${runId}`;
+  const shortSha = formatSha(prSha);
+  const time = getTimeString();
 
   const allSuccess = targets.every(t => t.status === 'success');
   const anyCancelled = targets.some(t => t.status === 'cancelled');
+  const anyFailure = targets.some(t => t.status === 'failure');
 
-  const headerIcon = allSuccess
-    ? '✅ 构建成功'
-    : anyCancelled
-      ? '⚪ 构建已取消'
-      : '❌ 构建失败';
+  // 状态徽章
+  let statusBadge: string;
+  let headerTitle: string;
+  if (allSuccess) {
+    statusBadge = '![Success](https://img.shields.io/badge/状态-构建成功-success?style=for-the-badge&logo=github-actions&logoColor=white)';
+    headerTitle = '# ✅ NapCat 构建成功';
+  } else if (anyCancelled && !anyFailure) {
+    statusBadge = '![Cancelled](https://img.shields.io/badge/状态-已取消-lightgrey?style=for-the-badge&logo=github-actions&logoColor=white)';
+    headerTitle = '# ⚪ NapCat 构建已取消';
+  } else {
+    statusBadge = '![Failed](https://img.shields.io/badge/状态-构建失败-critical?style=for-the-badge&logo=github-actions&logoColor=white)';
+    headerTitle = '# ❌ NapCat 构建失败';
+  }
 
   const downloadLink = (target: BuildTarget) => {
     if (target.status !== 'success') return '—';
     if (target.downloadUrl) {
-      return `[📦 下载](${target.downloadUrl})`;
+      return `[📥 下载](${target.downloadUrl})`;
     }
-    // 回退到 run 详情页
-    return `[📦 下载](${runUrl}#artifacts)`;
+    return `[📥 下载](${runUrl}#artifacts)`;
   };
 
   const lines: string[] = [
     COMMENT_MARKER,
-    `## ${headerIcon}`,
     '',
-    '| 构建目标 | 状态 | 下载 |',
-    '| :--- | :--- | :--- |',
-    ...targets.map(t => `| ${t.name} | ${getStatusIcon(t.status)} | ${downloadLink(t)} |`),
+    '<div align="center">',
+    '',
+    headerTitle,
+    '',
+    statusBadge,
+    '',
+    '</div>',
     '',
     '---',
     '',
-    `📝 **提交**: \`${formatSha(prSha)}\``,
-    `🔗 **构建日志**: [查看详情](${runUrl})`,
+    '## 📦 构建产物',
+    '',
+    '| 包名 | 状态 | 下载 |',
+    '| :--- | :---: | :---: |',
+    ...targets.map(t => `| \`${t.name}\` | ${getStatusEmoji(t.status)} ${t.status === 'success' ? '成功' : t.status === 'failure' ? '失败' : t.status === 'cancelled' ? '已取消' : '未知'} | ${downloadLink(t)} |`),
+    '',
+    '---',
+    '',
+    '## 📋 构建信息',
+    '',
+    `| 项目 | 值 |`,
+    `| :--- | :--- |`,
+    ...(version ? [`| 🏷️ 版本号 | \`${version}\` |`] : []),
+    `| 📝 提交 | \`${shortSha}\` |`,
+    `| 🔗 构建日志 | [查看详情](${runUrl}) |`,
+    `| 🕐 完成时间 | ${time} |`,
   ];
 
   // 添加错误详情
   const failedTargets = targets.filter(t => t.status === 'failure' && t.error);
   if (failedTargets.length > 0) {
-    lines.push('', '---', '', '## ⚠️ 错误详情');
+    lines.push('', '---', '', '## ⚠️ 错误详情', '');
     for (const target of failedTargets) {
-      lines.push('', `### ${target.name} 构建错误`, '```', escapeCodeBlock(target.error!), '```');
+      lines.push(
+        `<details>`,
+        `<summary>🔴 <b>${target.name}</b> 构建错误</summary>`,
+        '',
+        '```',
+        escapeCodeBlock(target.error!),
+        '```',
+        '',
+        '</details>',
+        ''
+      );
     }
   }
 
   // 添加底部提示
+  lines.push('---', '');
   if (allSuccess) {
-    lines.push('', '> 🎉 所有构建均已成功完成，可点击上方下载链接获取构建产物进行测试。');
-  } else if (anyCancelled) {
-    lines.push('', '> ⚪ 构建已被取消，可能是由于新的提交触发了新的构建。');
+    lines.push(
+      '<div align="center">',
+      '',
+      '> 🎉 **所有构建均已成功完成！**',
+      '>',
+      '> 点击上方下载链接获取构建产物进行测试',
+      '',
+      '</div>'
+    );
+  } else if (anyCancelled && !anyFailure) {
+    lines.push(
+      '<div align="center">',
+      '',
+      '> ⚪ **构建已被取消**',
+      '>',
+      '> 可能是由于新的提交触发了新的构建',
+      '',
+      '</div>'
+    );
   } else {
-    lines.push('', '> ⚠️ 部分构建失败，请查看上方错误详情或点击构建日志查看完整输出。');
+    lines.push(
+      '<div align="center">',
+      '',
+      '> ⚠️ **部分构建失败**',
+      '>',
+      '> 请查看上方错误详情或点击构建日志查看完整输出',
+      '',
+      '</div>'
+    );
   }
 
   return lines.join('\n');
 }
+

.github/scripts/pr-build-result.ts

@@ -6,6 +6,7 @@
  * - PR_NUMBER: PR 编号
  * - PR_SHA: PR 提交 SHA
  * - RUN_ID: GitHub Actions Run ID
+ * - NAPCAT_VERSION: 构建版本号
  * - FRAMEWORK_STATUS: Framework 构建状态
  * - FRAMEWORK_ERROR: Framework 构建错误信息
  * - SHELL_STATUS: Shell 构建状态
@@ -30,6 +31,7 @@ async function main (): Promise<void> {
   const prNumber = parseInt(getEnv('PR_NUMBER', true), 10);
   const prSha = getEnv('PR_SHA') || 'unknown';
   const runId = getEnv('RUN_ID', true);
+  const version = getEnv('NAPCAT_VERSION') || '';
   const { owner, repo } = getRepository();
 
   const frameworkStatus = parseStatus(getEnv('FRAMEWORK_STATUS'));
@@ -39,6 +41,7 @@ async function main (): Promise<void> {
 
   console.log(`PR: #${prNumber}`);
   console.log(`SHA: ${prSha}`);
+  console.log(`Version: ${version}`);
   console.log(`Run: ${runId}`);
   console.log(`Framework: ${frameworkStatus}${frameworkError ? ` (${frameworkError})` : ''}`);
   console.log(`Shell: ${shellStatus}${shellError ? ` (${shellError})` : ''}\n`);
@@ -76,7 +79,7 @@ async function main (): Promise<void> {
     },
   ];
 
-  const comment = generateResultComment(targets, prSha, runId, repository);
+  const comment = generateResultComment(targets, prSha, runId, repository, version);
 
   await github.createOrUpdateComment(owner, repo, prNumber, comment, COMMENT_MARKER);
 }

.github/workflows/build.yml

@@ -13,11 +13,27 @@ jobs:
     steps:
       - name: Clone Main Repository
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # 需要完整历史来获取 tags
       - name: Use Node.js 20.X
         uses: actions/setup-node@v4
         with:
           node-version: 20.x
+      - name: Generate Version
+        run: |
+          # 获取最近的 release tag (格式: vX.X.X)
+          LATEST_TAG=$(git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*" 2>/dev/null || echo "v0.0.0")
+          # 去掉 v 前缀
+          BASE_VERSION="${LATEST_TAG#v}"
+          SHORT_SHA="${GITHUB_SHA::7}"
+          VERSION="${BASE_VERSION}-main.${{ github.run_number }}+${SHORT_SHA}"
+          echo "NAPCAT_VERSION=${VERSION}" >> $GITHUB_ENV
+          echo "Latest tag: ${LATEST_TAG}"
+          echo "Build version: ${VERSION}"
       - name: Build NapCat.Framework
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NAPCAT_VERSION: ${{ env.NAPCAT_VERSION }}
         run: |
           npm i -g pnpm
           pnpm i
@@ -39,11 +55,27 @@ jobs:
     steps:
       - name: Clone Main Repository
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # 需要完整历史来获取 tags
       - name: Use Node.js 20.X
         uses: actions/setup-node@v4
         with:
           node-version: 20.x
+      - name: Generate Version
+        run: |
+          # 获取最近的 release tag (格式: vX.X.X)
+          LATEST_TAG=$(git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*" 2>/dev/null || echo "v0.0.0")
+          # 去掉 v 前缀
+          BASE_VERSION="${LATEST_TAG#v}"
+          SHORT_SHA="${GITHUB_SHA::7}"
+          VERSION="${BASE_VERSION}-main.${{ github.run_number }}+${SHORT_SHA}"
+          echo "NAPCAT_VERSION=${VERSION}" >> $GITHUB_ENV
+          echo "Latest tag: ${LATEST_TAG}"
+          echo "Build version: ${VERSION}"
       - name: Build NapCat.Shell
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NAPCAT_VERSION: ${{ env.NAPCAT_VERSION }}
         run: |
           npm i -g pnpm
           pnpm i

.github/workflows/pr-build.yml

@@ -126,6 +126,7 @@ jobs:
     outputs:
       status: ${{ steps.build.outcome }} # 构建结果：success/failure
       error: ${{ steps.build.outputs.error }} # 错误信息（如有）
+      version: ${{ steps.version.outputs.version }} # 构建版本号
     steps:
       # 【安全】先从 base 分支 checkout 构建脚本
       # 这样即使 PR 中修改了脚本，也不会被执行
@@ -143,16 +144,36 @@ jobs:
           repository: ${{ needs.check-build.outputs.pr_head_repo }}
           ref: ${{ needs.check-build.outputs.pr_sha }}
           path: workspace
+          fetch-depth: 0  # 需要完整历史来获取 tags
 
       - name: Setup Node.js 24
         uses: actions/setup-node@v4
         with:
           node-version: 24
 
+      # 获取最新 release tag 并生成版本号
+      - name: Generate Version
+        id: version
+        working-directory: workspace
+        run: |
+          # 获取最近的 release tag (格式: vX.X.X)
+          LATEST_TAG=$(git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*" 2>/dev/null || echo "v0.0.0")
+          # 去掉 v 前缀
+          BASE_VERSION="${LATEST_TAG#v}"
+          SHORT_SHA="${{ needs.check-build.outputs.pr_sha }}"
+          SHORT_SHA="${SHORT_SHA::7}"
+          VERSION="${BASE_VERSION}-pr.${{ needs.check-build.outputs.pr_number }}.${{ github.run_number }}+${SHORT_SHA}"
+          echo "NAPCAT_VERSION=${VERSION}" >> $GITHUB_ENV
+          echo "Latest tag: ${LATEST_TAG}"
+          echo "Build version: ${VERSION}"
+
       # 执行构建，使用 base 分支的脚本处理 workspace 中的代码
       - name: Build
         id: build
         working-directory: workspace
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NAPCAT_VERSION: ${{ env.NAPCAT_VERSION }}
         run: node --experimental-strip-types ../_scripts/.github/scripts/pr-build-run.ts framework
         continue-on-error: true # 允许失败，后续更新评论时处理
 
@@ -177,6 +198,8 @@ jobs:
     outputs:
       status: ${{ steps.build.outcome }} # 构建结果：success/failure
       error: ${{ steps.build.outputs.error }} # 错误信息（如有）
+      version: ${{ steps.version.outputs.version }} # 构建版本号
+      version: ${{ steps.version.outputs.version }} # 构建版本号
     steps:
       # 【安全】先从 base 分支 checkout 构建脚本
       - name: Checkout scripts from base
@@ -193,16 +216,37 @@ jobs:
           repository: ${{ needs.check-build.outputs.pr_head_repo }}
           ref: ${{ needs.check-build.outputs.pr_sha }}
           path: workspace
+          fetch-depth: 0  # 需要完整历史来获取 tags
 
       - name: Setup Node.js 24
         uses: actions/setup-node@v4
         with:
           node-version: 24
 
+      # 获取最新 release tag 并生成版本号
+      - name: Generate Version
+        id: version
+        working-directory: workspace
+        run: |
+          # 获取最近的 release tag (格式: vX.X.X)
+          LATEST_TAG=$(git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*" 2>/dev/null || echo "v0.0.0")
+          # 去掉 v 前缀
+          BASE_VERSION="${LATEST_TAG#v}"
+          SHORT_SHA="${{ needs.check-build.outputs.pr_sha }}"
+          SHORT_SHA="${SHORT_SHA::7}"
+          VERSION="${BASE_VERSION}-pr.${{ needs.check-build.outputs.pr_number }}.${{ github.run_number }}+${SHORT_SHA}"
+          echo "NAPCAT_VERSION=${VERSION}" >> $GITHUB_ENV
+          echo "version=${VERSION}" >> $GITHUB_OUTPUT
+          echo "Latest tag: ${LATEST_TAG}"
+          echo "Build version: ${VERSION}"
+
       # 执行构建
       - name: Build
         id: build
         working-directory: workspace
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NAPCAT_VERSION: ${{ env.NAPCAT_VERSION }}
         run: node --experimental-strip-types ../_scripts/.github/scripts/pr-build-run.ts shell
         continue-on-error: true
 
@@ -244,6 +288,8 @@ jobs:
           PR_NUMBER: ${{ needs.check-build.outputs.pr_number }}
           PR_SHA: ${{ needs.check-build.outputs.pr_sha }}
           RUN_ID: ${{ github.run_id }}
+          # 构建版本号
+          NAPCAT_VERSION: ${{ needs.build-framework.outputs.version || needs.build-shell.outputs.version || '' }}
           # 获取构建状态，如果 job 被跳过则标记为 cancelled
           FRAMEWORK_STATUS: ${{ needs.build-framework.outputs.status || 'cancelled' }}
           FRAMEWORK_ERROR: ${{ needs.build-framework.outputs.error }}

.github/workflows/release.yml

@@ -4,13 +4,16 @@ on:
   workflow_dispatch:
   push:
     tags:
-      - '*'
+      - 'v[0-9]*.[0-9]*.[0-9]*'
+      - 'v[0-9]*.[0-9]*.[0-9]*-*'
+      - 'v[0-9]*.[0-9]*.[0-9]*+*'
+      - 'v[0-9]*.[0-9]*.[0-9]*-*+*'
 
 permissions: write-all
 
 env:
   OPENROUTER_API_URL: https://91vip.futureppo.top/v1/chat/completions
-  OPENROUTER_MODEL: "kimi-k2-0905-turbo"
+  OPENROUTER_MODEL: "Antigravity/gemini-3-flash-preview"
   RELEASE_NAME: "NapCat"
 
 jobs:
@@ -24,6 +27,8 @@ jobs:
         with:
           node-version: 20.x
       - name: Build NapCat.Framework
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           npm i -g pnpm
           pnpm i
@@ -49,6 +54,8 @@ jobs:
         with:
           node-version: 20.x
       - name: Build NapCat.Shell
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           npm i -g pnpm
           pnpm i
@@ -171,7 +178,7 @@ jobs:
 
       - name: Generate release note via OpenRouter
         env:
-          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
+          OPENAI_KEY: ${{ secrets.OPENAI_KEY }}
           OPENROUTER_API_URL: ${{ env.OPENROUTER_API_URL }}
           OPENROUTER_MODEL: ${{ env.OPENROUTER_MODEL }}
           GITHUB_OWNER: "NapNeKo"   # 替换成你的 repo owner
@@ -233,7 +240,7 @@ jobs:
 
           # 调用 OpenRouter
           if RESPONSE=$(curl -s -X POST "$OPENROUTER_API_URL" \
-            -H "Authorization: Bearer $OPENROUTER_API_KEY" \
+            -H "Authorization: Bearer $OPENAI_KEY" \
             -H "Content-Type: application/json" \
             -d "$BODY"); then
             echo "=== raw response ==="