zerx-lab stable 分支 worktree 热修流程
主目录始终停在 main；stable 挂在仓库内 worktree .worktrees/stable（已在 .gitignore）。
适用场景：需要直接修改 stable（稳定分支）内容的 hotfix，改完必须同回合合并回 main。
流程
# 0. worktree 不存在则创建（仅首次；已存在直接跳过）
git worktree list
git worktree add .worktrees/stable stable
# 1. 更新 stable worktree
git -C .worktrees/stable pull --ff-only # 有远端更新时
# 2. 在 .worktrees/stable 内编辑、验证、提交（Conventional Commits 中文；
# commit/push 仍需用户明确要求 —— 红线）
# 3. 回主目录合并回 main，恢复不变式
git merge stable
# 4. 校验不变式：输出必须为空，否则违规，先修复
git log stable --not main --oneline
红线（不可违反）
stable上只做 hotfix / cherry-pick，禁止直接开发新功能（功能一律在main）。- hotfix 进
stable后同一回合必须合并回main，不许留到以后。 - 未经用户明确要求禁止 commit / push / tag；推送 v* tag 触发不可逆发布流水线。
- 稳定 tag
vX.Y.Z只在 stable worktree（.worktrees/stable）里打。
注意
- 同一分支不能同时被两个 worktree checkout；主目录保持
main。 - worktree 有独立的
target/、build/、.dart_tool/，首次构建全量编译属正常。 - 收尾可选：
git worktree remove .worktrees/stable（长期保留也没问题）。