Git 工作流大师

main ─────●────●────●────●────●─── （始终可部署）
           \  /      \  /
            ●         ●          （短生命周期的特性分支）

main    ─────●─────────────●───── （仅发布）
develop ───●───●───●───●───●───── （集成分支）
             \   /     \  /
              ●─●       ●●       （特性分支）

main      ─────●──────────────●──── （生产）
release/1.2 ────●────●────●──/     （发布候选）
release/1.3 ──────────────●────●── （下一个版本）

git fetch origin
git checkout -b feat/my-feature origin/main
# 或使用工作树实现并行开发：
git worktree add ../my-feature feat/my-feature

git fetch origin
git rebase -i origin/main    # 合并 fixup，修改提交信息
git push --force-with-lease   # 安全地强推到你的分支

# 确保 CI 通过，获得审批，然后：
git checkout main
git merge --no-ff feat/my-feature  # 或通过 PR 使用 squash merge
git branch -d feat/my-feature
git push origin --delete feat/my-feature

# 1. 从生产分支创建 hotfix
git checkout -b hotfix/critical-bug origin/main

# 2. 修复、测试、提交
git commit -m "fix: 修复支付回调中的金额精度丢失

金额字段使用 float 导致 0.1+0.2!=0.3 的精度问题。
改用 Decimal 类型处理所有货币运算。

Fixes #1234"

# 3. 合并回 main 和 develop（如果使用 Git Flow）
git checkout main && git merge --no-ff hotfix/critical-bug
git checkout develop && git merge --no-ff hotfix/critical-bug
git branch -d hotfix/critical-bug

git bisect start
git bisect bad HEAD          # 当前版本有 bug
git bisect good v1.2.0       # 这个版本是好的
# Git 会自动二分查找，你只需要对每个版本运行测试
git bisect run npm test       # 全自动定位
git bisect reset              # 完成后恢复

# 不小心 reset --hard 了？别慌
git reflog
# 找到丢失的 commit SHA
git checkout -b recovery abc1234

# 正在改 feature A，突然需要修 bug
git worktree add ../hotfix-branch hotfix/urgent-fix
# 在 ../hotfix-branch 目录修完 bug，不影响当前工作
cd ../hotfix-branch
# 修完后清理
git worktree remove ../hotfix-branch

<类型>(<范围>): <简短描述>

<正文：解释为什么做这个改动>

<脚注：关联 Issue、Breaking Change 等>

feat(auth): 增加基于 TOTP 的双因素认证

用户反馈账户安全需求强烈（Issue #892），增加 TOTP 作为
可选的第二认证因素。选择 TOTP 而非 SMS 是因为不依赖
手机信号且更安全（SIM swap 攻击无效）。

Closes #892

❌ fix stuff
❌ update code
❌ WIP
❌ 修复 bug（哪个 bug？为什么会有这个 bug？）

# GitHub Branch Protection 推荐配置
main:
  required_reviews: 1
  dismiss_stale_reviews: true
  require_status_checks:
    - lint
    - test
    - build
  require_linear_history: true    # 强制 rebase merge
  restrict_force_push: true

# 基于约定式提交自动生成 changelog 和版本号
# feat: → minor 版本号 +1
# fix:  → patch 版本号 +1
# BREAKING CHANGE: → major 版本号 +1
npx standard-version  # 或 semantic-release