NapCatQQ/.github/scripts/lib/comment.ts

/**
 * 构建状态评论模板
 */

export const COMMENT_MARKER = '<!-- napcat-pr-build -->';

export type BuildStatus = 'success' | 'failure' | 'cancelled' | 'pending' | 'unknown';

export interface BuildTarget {
  name: string;
  status: BuildStatus;
  error?: string;
  downloadUrl?: string;  // Artifact 直接下载链接
}

// ============== 辅助函数 ==============

function formatSha (sha: string): string {
  return sha && sha.length >= 7 ? sha.substring(0, 7) : sha || 'unknown';
}

function escapeCodeBlock (text: string): string {
  // 替换 ``` 为转义形式，避免破坏 Markdown 代码块
  return text.replace(/```/g, '\\`\\`\\`');
}

function getTimeString (): string {
  return new Date().toISOString().replace('T', ' ').substring(0, 19) + ' UTC';
}

// ============== 状态图标 ==============

export function getStatusIcon (status: BuildStatus): string {
  switch (status) {
    case 'success':
      return '✅ 成功';
    case 'pending':
      return '⏳ 构建中...';
    case 'cancelled':
      return '⚪ 已取消';
    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 = getTimeString();
  const shortSha = formatSha(prSha);

  const lines: string[] = [
    COMMENT_MARKER,
    '',
    '<div align="center">',
    '',
    '# 🔨 NapCat 构建中',
    '',
    '![Building](https://img.shields.io/badge/状态-构建中-yellow?style=for-the-badge&logo=github-actions&logoColor=white)',
    '',
    '</div>',
    '',
    '---',
    '',
    '## 📦 构建目标',
    '',
    '| 包名 | 状态 | 说明 |',
    '| :--- | :---: | :--- |',
    ...targets.map(name => `| \`${name}\` | ⏳ | 正在构建... |`),
    '',
    '---',
    '',
    '## 📋 构建信息',
    '',
    `| 项目 | 值 |`,
    `| :--- | :--- |`,
    `| 📝 提交 | \`${shortSha}\` |`,
    `| 🕐 开始时间 | ${time} |`,
    '',
    '---',
    '',
    '<div align="center">',
    '',
    '> ⏳ **构建进行中，请稍候...**',
    '>',
    '> 构建完成后将自动更新此评论',
    '',
    '</div>',
  ];

  return lines.join('\n');
}

// ============== 构建结果评论 ==============

export function generateResultComment (
  targets: BuildTarget[],
  prSha: string,
  runId: string,
  repository: string,
  version?: string
): string {
  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');

  // 状态徽章
  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 `[📥 下载](${runUrl}#artifacts)`;
  };

  const lines: string[] = [
    COMMENT_MARKER,
    '',
    '<div align="center">',
    '',
    headerTitle,
    '',
    statusBadge,
    '',
    '</div>',
    '',
    '---',
    '',
    '## 📦 构建产物',
    '',
    '| 包名 | 状态 | 下载 |',
    '| :--- | :---: | :---: |',
    ...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('', '---', '', '## ⚠️ 错误详情', '');
    for (const target of failedTargets) {
      lines.push(
        `<details>`,
        `<summary>🔴 <b>${target.name}</b> 构建错误</summary>`,
        '',
        '```',
        escapeCodeBlock(target.error!),
        '```',
        '',
        '</details>',
        ''
      );
    }
  }

  // 添加底部提示
  lines.push('---', '');
  if (allSuccess) {
    lines.push(
      '<div align="center">',
      '',
      '> 🎉 **所有构建均已成功完成！**',
      '>',
      '> 点击上方下载链接获取构建产物进行测试',
      '',
      '</div>'
    );
  } else if (anyCancelled && !anyFailure) {
    lines.push(
      '<div align="center">',
      '',
      '> ⚪ **构建已被取消**',
      '>',
      '> 可能是由于新的提交触发了新的构建',
      '',
      '</div>'
    );
  } else {
    lines.push(
      '<div align="center">',
      '',
      '> ⚠️ **部分构建失败**',
      '>',
      '> 请查看上方错误详情或点击构建日志查看完整输出',
      '',
      '</div>'
    );
  }

  return lines.join('\n');
}