b9348/sfmmm/version-bump

Auto Version Bump & Release

版本号由本地 pre-commit hook 自动更新，push 到 main 分支后 GitHub Actions 自动构建 NSIS 安装包、上传到图床 CDN、创建 GitHub Release，并将版本号和下载链接写入云端数据库 version_config 表。

版本号更新机制

本地 pre-commit hook（自动 bump）

每次 commit 时，.git/hooks/pre-commit 会自动：

1. 从 src-tauri/tauri.conf.json 读取当前版本
2. 解析 semver，patch +1（例如 0.1.0 → 0.1.1）
3. 更新以下 3 个文件中的版本号：

1. 将更新的文件加入 staging area

跳过版本更新：commit message 包含 [skip version] 即可跳过（适用于文档变更等无需发版的提交）。

工作流文件

.github/workflows/release.yml

触发条件

• push 到 main 分支

工作流概览

push → [Build NSIS installer] → [Create Release & Update Cloud]
                                 ↓
                       ImgBed CDN 上传 + MySQL 直连更新

Job 1: Build NSIS installer (windows-latest)

1. 从 src-tauri/tauri.conf.json 读取当前版本
2. 创建 git tag（如不存在）
3. 安装 pnpm、Node.js、Rust
4. 注入 DB_URL 环境变量
5. 执行 pnpm tauri build
6. 产出的 .exe 上传为 artifact

Job 2: Create Release & Update Cloud (ubuntu-latest)

1. 使用 softprops/action-gh-release 创建 GitHub Release

• 标题: v{x.y.z}
• 附件: NSIS 安装包
• 自动生成 release notes

1. 将 .exe 上传到 ImgBed 图床 CDN（img.b9349.dpdns.org），通过 Telegram 渠道分发

• 上传路径: sfm/installer/v{x.y.z}/
• 授权方式: Authorization: Bearer ${{ secrets.IMGBED_TOKEN }}

1. 通过 `DB_URL` 直连 MySQL，更新 version_config 表：

• 版本号 → version 字段
• ImgBed 直链 → update_url 字段

⚠️ sfm.b9349.dpdns.org 从 GitHub Actions 网络不可达（ETIMEDOUT），

因此不通过 Cloud API 更新版本配置，改用 MySQL 直连。

跳过版本 Bump

在 commit 的 subject 行（第一行） 中包含 [skip version]：

git commit -m "docs: update readme [skip version]"

适用于：文档变更、CI 配置调整、注释修改等无需发版的提交。

手动触发

如果要手动创建一个 release 而不 push 到 main：

1. 本地修改版本号（3 个文件）
2. commit + tag: git tag v{x.y.z}
3. git push origin main --tags

版本号同步

由于版本号由本地 pre-commit hook 自动更新，本地和远程始终保持一致：

• 每次 commit 时自动 bump patch 版本号
• push 到 main 后 CI 直接构建发布
• 不会再有 CI 创建额外 commit 导致的版本差异

所需的 GitHub Secrets

版本号位置

更新检测链路

桌面端 (用户)
  │  GET https://sfm.b9349.dpdns.org/api/admin/version  (公开接口，无需认证)
  │  返回 { version, update_url }
  ↓
比较本地 CURRENT_VERSION vs 云端 version
  │
  ├─ 无更新 → 提示"已是最新版"
  └─ 有新版本 → 显示"下载更新"按钮，链接到 ImgBed 直链
 
ImgBed 直链格式:
  https://img.b9349.dpdns.org/file/sfm/installer/v{x.y.z}/{timestamp}_sfmmm_{x.y.z}_x64-setup.exe

云端数据库 version_config 表

本地更新检测代码

• src/services/updateApi.js — checkVersion(currentVersion) 调云端 API 比较版本
• src/modules/settings/GameSettings.jsx — 显示更新面板和下载按钮

gh CLI

已安装 gh CLI（v2.83.2），可用于：

• 查看 workflow 运行状态：gh run list
• 查看 workflow 日志：gh run view <run-id> --log
• 查看 releases：gh release list