feat: 添加 GitHub Actions CI/CD 自动化配置

[sansi-lcj]

概述

添加完整的 GitHub Actions CI/CD 自动化流程，包括 CI 检查、NPM 自动发布和文档部署。

主要变更

1. CI 工作流 (.github/workflows/ci.yml)

• ✅ Pull Request 和 push 到 main 时自动运行
• ✅ Node.js 18 和 20 多版本矩阵测试
• ✅ 自动构建主包和测试应用验证

2. NPM 发布工作流 (.github/workflows/publish.yml)

• ✅ 推送版本标签时自动发布到 npm
• ✅ 支持语义化版本：
  • v*.*.* → npm latest tag
  • v*.*.*-alpha.* → npm alpha tag
  • v*.*.*-beta.* → npm beta tag
  • v*.*.*-rc.* → npm rc tag
• ✅ 自动创建 GitHub Release
• ✅ 使用组织级别的 NPM_AUTH_TOKEN

3. 文档部署工作流 (.github/workflows/docs.yml)

• ✅ push 到 main 或发布新版本时自动部署
• ✅ 自动生成 TypeDoc 文档
• ✅ 部署到 GitHub Pages

4. 项目配置更新

• ✅ 更新 README 添加徽章和发布流程说明
• ✅ 添加 PR 模板
• ✅ 添加配置指南 (.github/SETUP.md)
• ✅ 更新 .gitignore 忽略构建产物
• ✅ 修正 typedoc.json 路径配置

配置要求

已完成

• ✅ 组织已配置 NPM_AUTH_TOKEN secret

需要启用

• ⏳ GitHub Pages: Settings → Pages → Source: GitHub Actions

测试情况

• ✅ CI 工作流配置完成
• ✅ 文档构建成功（在 feature 分支上测试通过）
• ✅ Alpha 版本 v2.6.4-alpha.1 发布流程验证

版本发布流程

合并后，发布新版本的步骤：

# 1. 更新版本号
cd packages/vreo
npm version patch  # 或 minor/major

# 2. 推送代码和 tag
git push origin main
git push origin --tags

# 3. GitHub Actions 自动发布

文件变更

• .github/workflows/ci.yml - CI 检查工作流
• .github/workflows/publish.yml - NPM 发布工作流
• .github/workflows/docs.yml - 文档部署工作流
• .github/PULL_REQUEST_TEMPLATE.md - PR 模板
• .github/SETUP.md - 配置指南
• README.md - 更新说明和徽章
• .gitignore - 忽略构建产物
• packages/vreo/typedoc.json - 修正 CSS 路径

注意事项

• 本 PR 已清理所有构建产物（lib/、docs/）
• 这些文件将通过 CI/CD 自动生成
• 合并后首次推送到 main 会触发文档部署