WrBug
26dd3bb387
主要变更： 1. 动态更新功能 - 新增 Python 更新服务 (docker/update-service.py) - 添加系统更新前端页面 (frontend/src/pages/SystemUpdate.tsx) - 配置 Nginx 代理更新服务 API - 更新 Docker 启动脚本支持多进程管理 - 修复权限验证接口 (AuthController.verify) 2. Release 创建脚本 - 新增 create-release.sh 脚本支持快速创建 GitHub Release - 支持自动拼接 -beta 后缀（pre-release） - 支持无交互模式（--yes 参数） - 添加详细的使用文档 3. GitHub Actions 增强 - 添加更新包构建和上传流程 - 支持 Pre-release 检测和过滤 4. 文档完善 - 添加动态更新技术方案文档 - 添加 Docker 版本号确定流程文档 - 添加 Release 脚本使用说明
312 lines
8.2 KiB
Bash
312 lines
8.2 KiB
Bash
#!/bin/bash
|
||
|
||
# PolyHermes Release 创建脚本
|
||
# 功能：创建 tag、推送 tag、创建 GitHub Release（支持 pre-release）
|
||
|
||
set -e
|
||
|
||
# 颜色输出
|
||
RED='\033[0;31m'
|
||
GREEN='\033[0;32m'
|
||
YELLOW='\033[1;33m'
|
||
BLUE='\033[0;34m'
|
||
NC='\033[0m' # No Color
|
||
|
||
# 打印信息
|
||
info() {
|
||
echo -e "${BLUE}[INFO]${NC} $1"
|
||
}
|
||
|
||
success() {
|
||
echo -e "${GREEN}[SUCCESS]${NC} $1"
|
||
}
|
||
|
||
warn() {
|
||
echo -e "${YELLOW}[WARN]${NC} $1"
|
||
}
|
||
|
||
error() {
|
||
echo -e "${RED}[ERROR]${NC} $1"
|
||
}
|
||
|
||
# 显示使用说明
|
||
usage() {
|
||
cat << EOF
|
||
用法: $0 [选项]
|
||
|
||
选项:
|
||
-t, --tag TAG 版本号 tag（必需，格式：v1.0.0）
|
||
-T, --title TITLE Release 标题（可选，默认使用 tag）
|
||
-d, --description DESC Release 描述内容（可选）
|
||
-f, --description-file FILE 从文件读取 Release 描述（可选）
|
||
-p, --prerelease 标记为 Pre-release（会自动拼接 -beta 后缀，默认：false）
|
||
-h, --help 显示此帮助信息
|
||
|
||
示例:
|
||
# 创建正式版本
|
||
$0 -t v1.0.1 -T "Release v1.0.1" -d "## 新功能\n- 功能1\n- 功能2"
|
||
|
||
# 创建 Pre-release（自动拼接 -beta）
|
||
$0 -t v1.0.1 -T "Release v1.0.1-beta" -d "测试版本" --prerelease
|
||
# 实际创建的 tag: v1.0.1-beta
|
||
|
||
# 从文件读取描述
|
||
$0 -t v1.0.1 -f CHANGELOG.md --prerelease
|
||
# 实际创建的 tag: v1.0.1-beta
|
||
|
||
版本号格式:
|
||
- 必须格式: v数字.数字.数字 (例如: v1.0.0, v1.10.2, v1.1.12)
|
||
- 如果指定 --prerelease，会自动拼接 -beta 后缀 (例如: v1.0.1 -> v1.0.1-beta)
|
||
|
||
EOF
|
||
}
|
||
|
||
# 验证版本号格式（只允许 v数字.数字.数字，不允许后缀）
|
||
validate_tag() {
|
||
local tag=$1
|
||
# 匹配格式：v数字.数字.数字（不允许后缀）
|
||
if [[ ! "$tag" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
|
||
error "版本号格式不正确：$tag"
|
||
error "应为 v数字.数字.数字 (例如: v1.0.0, v1.10.2, v1.1.12)"
|
||
error "如果创建 Pre-release，请使用 --prerelease 参数，脚本会自动拼接 -beta 后缀"
|
||
exit 1
|
||
fi
|
||
return 0
|
||
}
|
||
|
||
# 检查必要的工具
|
||
check_requirements() {
|
||
# 检查 git
|
||
if ! command -v git &> /dev/null; then
|
||
error "未找到 git 命令，请先安装 git"
|
||
exit 1
|
||
fi
|
||
|
||
# 检查 GitHub CLI
|
||
if ! command -v gh &> /dev/null; then
|
||
error "未找到 GitHub CLI (gh) 命令"
|
||
error "请先安装 GitHub CLI: https://cli.github.com/"
|
||
exit 1
|
||
fi
|
||
|
||
# 检查是否已登录 GitHub
|
||
if ! gh auth status &> /dev/null; then
|
||
error "未登录 GitHub，请先运行: gh auth login"
|
||
exit 1
|
||
fi
|
||
|
||
# 检查是否有未提交的更改
|
||
if [[ -n $(git status --porcelain) ]]; then
|
||
warn "检测到未提交的更改，建议先提交或暂存"
|
||
read -p "是否继续？(y/N): " -n 1 -r
|
||
echo
|
||
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
|
||
info "已取消"
|
||
exit 0
|
||
fi
|
||
fi
|
||
|
||
# 检查是否在正确的分支
|
||
local current_branch=$(git branch --show-current)
|
||
info "当前分支: $current_branch"
|
||
}
|
||
|
||
# 检查 tag 是否已存在
|
||
check_tag_exists() {
|
||
local tag=$1
|
||
if git rev-parse "$tag" >/dev/null 2>&1; then
|
||
error "Tag $tag 已存在（本地）"
|
||
read -p "是否删除并重新创建？(y/N): " -n 1 -r
|
||
echo
|
||
if [[ $REPLY =~ ^[Yy]$ ]]; then
|
||
git tag -d "$tag" || true
|
||
git push origin ":refs/tags/$tag" || true
|
||
info "已删除旧 tag: $tag"
|
||
else
|
||
error "已取消"
|
||
exit 1
|
||
fi
|
||
fi
|
||
|
||
# 检查远程是否存在
|
||
if git ls-remote --tags origin "$tag" | grep -q "$tag"; then
|
||
error "Tag $tag 已存在于远程仓库"
|
||
read -p "是否删除并重新创建？(y/N): " -n 1 -r
|
||
echo
|
||
if [[ $REPLY =~ ^[Yy]$ ]]; then
|
||
git tag -d "$tag" || true
|
||
git push origin ":refs/tags/$tag" || true
|
||
info "已删除远程 tag: $tag"
|
||
else
|
||
error "已取消"
|
||
exit 1
|
||
fi
|
||
fi
|
||
}
|
||
|
||
# 主函数
|
||
main() {
|
||
local TAG=""
|
||
local TITLE=""
|
||
local DESCRIPTION=""
|
||
local DESCRIPTION_FILE=""
|
||
local PRERELEASE=false
|
||
|
||
# 解析参数
|
||
while [[ $# -gt 0 ]]; do
|
||
case $1 in
|
||
-t|--tag)
|
||
TAG="$2"
|
||
shift 2
|
||
;;
|
||
-T|--title)
|
||
TITLE="$2"
|
||
shift 2
|
||
;;
|
||
-d|--description)
|
||
DESCRIPTION="$2"
|
||
shift 2
|
||
;;
|
||
-f|--description-file)
|
||
DESCRIPTION_FILE="$2"
|
||
shift 2
|
||
;;
|
||
-p|--prerelease)
|
||
PRERELEASE=true
|
||
shift
|
||
;;
|
||
-h|--help)
|
||
usage
|
||
exit 0
|
||
;;
|
||
*)
|
||
error "未知参数: $1"
|
||
usage
|
||
exit 1
|
||
;;
|
||
esac
|
||
done
|
||
|
||
# 检查必需参数
|
||
if [[ -z "$TAG" ]]; then
|
||
error "缺少必需参数: --tag"
|
||
usage
|
||
exit 1
|
||
fi
|
||
|
||
# 验证版本号格式（不允许后缀）
|
||
validate_tag "$TAG"
|
||
|
||
# 如果指定了 --prerelease，自动拼接 -beta 后缀
|
||
local BASE_TAG="$TAG"
|
||
if [[ "$PRERELEASE" == "true" ]]; then
|
||
TAG="${BASE_TAG}-beta"
|
||
info "Pre-release 模式：tag 将自动拼接 -beta 后缀"
|
||
info "基础版本: $BASE_TAG -> 实际 tag: $TAG"
|
||
fi
|
||
|
||
# 检查工具和环境
|
||
check_requirements
|
||
|
||
# 检查 tag 是否已存在（使用拼接后的 tag）
|
||
check_tag_exists "$TAG"
|
||
|
||
# 设置默认标题
|
||
if [[ -z "$TITLE" ]]; then
|
||
TITLE="$TAG"
|
||
fi
|
||
|
||
# 读取描述内容
|
||
if [[ -n "$DESCRIPTION_FILE" ]]; then
|
||
if [[ ! -f "$DESCRIPTION_FILE" ]]; then
|
||
error "描述文件不存在: $DESCRIPTION_FILE"
|
||
exit 1
|
||
fi
|
||
DESCRIPTION=$(cat "$DESCRIPTION_FILE")
|
||
fi
|
||
|
||
# 如果没有描述，使用默认值
|
||
if [[ -z "$DESCRIPTION" ]]; then
|
||
if [[ "$PRERELEASE" == "true" ]]; then
|
||
DESCRIPTION="Pre-release $TAG"
|
||
else
|
||
DESCRIPTION="Release $TAG"
|
||
fi
|
||
fi
|
||
|
||
# 显示即将执行的操作
|
||
echo
|
||
info "========================================="
|
||
info " PolyHermes Release 创建"
|
||
info "========================================="
|
||
info "Tag: $TAG"
|
||
info "Title: $TITLE"
|
||
info "Pre-release: $PRERELEASE"
|
||
info "Description:"
|
||
echo "$DESCRIPTION" | sed 's/^/ /'
|
||
info "========================================="
|
||
echo
|
||
|
||
# 确认操作
|
||
read -p "确认创建 Release？(y/N): " -n 1 -r
|
||
echo
|
||
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
|
||
info "已取消"
|
||
exit 0
|
||
fi
|
||
|
||
# 1. 创建 tag（基于当前 HEAD）
|
||
info "创建 tag: $TAG"
|
||
git tag "$TAG"
|
||
success "Tag 创建成功: $TAG"
|
||
|
||
# 2. 推送 tag 到远程
|
||
info "推送 tag 到远程..."
|
||
git push origin "$TAG"
|
||
success "Tag 推送成功"
|
||
|
||
# 3. 创建 GitHub Release
|
||
info "创建 GitHub Release..."
|
||
|
||
local RELEASE_ARGS=(
|
||
"$TAG"
|
||
--title "$TITLE"
|
||
--notes "$DESCRIPTION"
|
||
)
|
||
|
||
if [[ "$PRERELEASE" == "true" ]]; then
|
||
RELEASE_ARGS+=(--prerelease)
|
||
fi
|
||
|
||
if gh release create "${RELEASE_ARGS[@]}"; then
|
||
success "GitHub Release 创建成功！"
|
||
|
||
# 获取 release URL
|
||
local RELEASE_URL=$(gh release view "$TAG" --json url -q .url)
|
||
info "Release URL: $RELEASE_URL"
|
||
|
||
echo
|
||
success "========================================="
|
||
success " Release 创建完成！"
|
||
success "========================================="
|
||
success "Tag: $TAG"
|
||
success "Pre-release: $PRERELEASE"
|
||
success "URL: $RELEASE_URL"
|
||
success "========================================="
|
||
echo
|
||
info "GitHub Actions 将自动触发构建流程"
|
||
|
||
if [[ "$PRERELEASE" == "true" ]]; then
|
||
warn "这是 Pre-release，GitHub Actions 不会发送 Telegram 通知"
|
||
fi
|
||
else
|
||
error "GitHub Release 创建失败"
|
||
error "请手动在 GitHub 上创建 Release: https://github.com/WrBug/PolyHermes/releases/new"
|
||
exit 1
|
||
fi
|
||
}
|
||
|
||
# 执行主函数
|
||
main "$@"
|
||
|