| name | version-bump |
| description | Document the auto version bump and GitHub Release workflow for this project. Use when user asks about version bumping, release process, CI/CD, or how to create a new release. |
| user_invocable | true |
| allowed_tools | Read, Glob, Grep, Bash |
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 会自动：
-
从 src-tauri/tauri.conf.json 读取当前版本
-
解析 semver，patch +1（例如 0.1.0 → 0.1.1）
-
更新以下 3 个文件中的版本号：
| 文件 | 字段 |
|---|
src-tauri/tauri.conf.json | version |
src-tauri/Cargo.toml | version (package) |
src/version.js | APP_VERSION |
-
将更新的文件加入 staging area
跳过版本更新：commit message 包含 [skip version] 即可跳过（适用于文档变更等无需发版的提交）。
工作流文件
.github/workflows/release.yml
触发条件
工作流概览
push → [Build NSIS installer] → [Create Release & Update Cloud]
↓
ImgBed CDN 上传 + MySQL 直连更新
Job 1: Build NSIS installer (windows-latest)
- 从
src-tauri/tauri.conf.json 读取当前版本
- 创建 git tag（如不存在）
- 安装 pnpm、Node.js、Rust
- 注入
DB_URL 环境变量
- 执行
pnpm tauri build
- 产出的
.exe 上传为 artifact
Job 2: Create Release & Update Cloud (ubuntu-latest)
- 使用
softprops/action-gh-release 创建 GitHub Release
- 标题:
v{x.y.z}
- 附件: NSIS 安装包
- 自动生成 release notes
- 将
.exe 上传到 ImgBed 图床 CDN（img.b9349.dpdns.org），通过 Telegram 渠道分发
- 上传路径:
sfm/installer/v{x.y.z}/
- 授权方式:
Authorization: Bearer ${{ secrets.IMGBED_TOKEN }}
- 通过
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：
- 本地修改版本号（3 个文件）
- commit + tag:
git tag v{x.y.z}
git push origin main --tags
版本号同步
由于版本号由本地 pre-commit hook 自动更新，本地和远程始终保持一致：
- 每次 commit 时自动 bump patch 版本号
- push 到 main 后 CI 直接构建发布
- 不会再有 CI 创建额外 commit 导致的版本差异
所需的 GitHub Secrets
| Secret | 用途 |
|---|
DB_URL | 构建时生成 .env；Release 时直连 MySQL 更新 version_config |
IMGBED_TOKEN | 上传安装包到图床 CDN（img.b9349.dpdns.org） |
版本号位置
| 位置 | 用途 |
|---|
src-tauri/tauri.conf.json | Tauri 应用版本（主版本来源） |
src-tauri/Cargo.toml | Rust crate 版本 |
src/modules/settings/GameSettings.jsx:69 | 前台显示的版本号 |
package.json | 当前为 0.0.0，未使用 |
MySQL version_config.version | 云端最新版本（供桌面端检测更新） |
更新检测链路
桌面端 (用户)
│ 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 表
| 字段 | 类型 | 说明 |
|---|
id | INT PK | 始终为 1（只有一条记录） |
version | VARCHAR(20) | 最新版本号，如 0.1.7 |
update_url | VARCHAR(500) | 安装包下载直链（ImgBed CDN） |
updated_at | TIMESTAMP | 最后更新时间（自动） |
本地更新检测代码
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
