团队协作工作流：Feature Branch、GitFlow 与 Fork/PR

echo '===== 功能分支工作流（Feature Branch）====='
git init -q --bare /tmp/up.git
git clone -q /tmp/up.git proj && cd proj
echo 'init' > app.txt && git add . && git commit -q -m "init"
git push -q -u origin main 2>/dev/null
echo '开一个功能分支开发新功能：'
git checkout -q -b feature/login
echo 'username field' > login.txt && git add . && git commit -q -m "feat: 登录表单"
echo 'username + password' >> login.txt && git add . && git commit -q -m "feat: 登录校验"
echo '功能分支历史：'
git log --oneline
echo
echo '回到 main 合并功能分支（--no-ff 保留分支痕迹）：'
git checkout -q main
git merge --no-ff -m "merge: 合入登录功能" feature/login
git log --oneline --graph --all
echo
echo '删除已合并的功能分支：'
git branch -d feature/login
git push -q origin main 2>/dev/null
echo 'main 最终历史：'
git log --oneline
cd ..

main        —— 永远对应已发布的生产代码（每个点都打 tag）
develop     —— 集成分支，下个版本的功能在此汇聚
feature/*   —— 从 develop 切出，开发完合回 develop（短期）
release/*   —— 从 develop 切出，只修 bug、打 tag，合回 main + develop
hotfix/*    —— 从 main 切出，紧急修生产 bug，合回 main + develop

echo '===== Fork + Pull Request 机制的本地模拟 ====='
git init -q --bare /tmp/up.git
git init -q --bare /tmp/fork.git
git clone -q /tmp/up.git mainline && cd mainline
echo 'project' > app.txt && git add . && git commit -q -m "init"
git push -q -u origin main 2>/dev/null
cd ..
 
echo '贡献者：克隆「自己的 fork」而不是官方仓库：'
git clone -q /tmp/fork.git contributor && cd contributor
git fetch -q /tmp/up.git main && git merge -q FETCH_HEAD 2>/dev/null
git push -q origin main 2>/dev/null
git remote add upstream /tmp/up.git
echo '贡献者的两个 remote（origin=fork, upstream=官方）：'
git remote -v
echo
echo '贡献者在功能分支上开发：'
git checkout -q -b fix/typo
echo 'fixed' >> app.txt && git add . && git commit -q -m "fix: 修正拼写"
echo '推到「自己的 fork」的 fix/typo 分支（这就是开 PR 的前提）：'
git push -q -u origin fix/typo 2>/dev/null
echo 'fork 上的分支：'
git branch -r
echo
cd ../mainline
echo '维护者：把贡献者 fork 里的分支 fetch 下来审查：'
git remote add contributor /tmp/fork.git
git fetch -q contributor fix/typo
echo '审查贡献者的提交：'
git log --oneline contributor/fix/typo
echo '没问题，合入官方 main：'
git merge --no-ff -m "merge PR#1: 修正拼写" contributor/fix/typo
git push -q origin main 2>/dev/null
echo '官方最终历史：'
git log --oneline --graph --all
cd ..