| 中文文章 | English article |
这个实验创建一个临时 Git 仓库，并建立下面这组真实引用：
HEAD -> refs/heads/main -> main commit
refs/heads/agent/draft -> agent commit
refs/tags/v1-light -> baseline commit
refs/tags/v1-annotated -> tag object -> baseline commit
运行：
lab_path=$(bash setup.sh)
bash verify.sh "$lab_path"
bash cleanup.sh "$lab_path"
setup.sh 的标准输出只有临时仓库路径。它禁用系统和全局 Git 配置，为这个仓库设置本地身份、关闭提交和标签签名，并把 hooks 路径设为空目录。这样可以避开个人签名设置和全局 hooks 对实验的影响。
先在执行 verify.sh 前检查中间状态：
git -C "$lab_path" log --oneline --decorate --all --graph
git -C "$lab_path" symbolic-ref --short HEAD
git -C "$lab_path" cat-file -t v1-light
git -C "$lab_path" cat-file -t v1-annotated
预期语义：
HEAD attached to main
v1-light is a commit
v1-annotated is a tag object
要亲自观察 detached HEAD，可以只在这个临时库中执行：
git -C "$lab_path" switch --detach v1-annotated
git -C "$lab_path" symbolic-ref -q HEAD || printf 'HEAD is detached\n'
printf 'keep this detached commit\n' > "$lab_path/detached.txt"
git -C "$lab_path" add detached.txt
git -C "$lab_path" commit -m "detached experiment"
git -C "$lab_path" branch keep-detached HEAD
git -C "$lab_path" switch main
新 commit 在 detached 状态下不会移动 main 或 agent/draft。keep-detached 给该 commit 加上一个可见引用，再切回 main。
verify.sh 用真实对象 ID、引用解析和对象类型断言当前状态；任何断言不成立都会以非零状态退出。它不只打印固定结果。cleanup.sh 只删除带有本实验标记的目录，并拒绝仓库根目录、用户主目录和根目录。
完整自测：
bash test.sh
This lab creates a temporary Git repository with these real references:
HEAD -> refs/heads/main -> main commit
refs/heads/agent/draft -> agent commit
refs/tags/v1-light -> baseline commit
refs/tags/v1-annotated -> tag object -> baseline commit
Run:
lab_path=$(bash setup.sh)
bash verify.sh "$lab_path"
bash cleanup.sh "$lab_path"
setup.sh prints only the temporary-repository path. It disables system and global Git configuration, sets a local identity, disables commit and tag signing, and points hooks to an empty directory. Personal signing settings and global hooks therefore do not affect the lab.
Inspect the intermediate state before running verify.sh:
git -C "$lab_path" log --oneline --decorate --all --graph
git -C "$lab_path" symbolic-ref --short HEAD
git -C "$lab_path" cat-file -t v1-light
git -C "$lab_path" cat-file -t v1-annotated
Expected meaning:
HEAD attached to main
v1-light is a commit
v1-annotated is a tag object
To observe a detached HEAD yourself, run these commands only in this temporary repository:
git -C "$lab_path" switch --detach v1-annotated
git -C "$lab_path" symbolic-ref -q HEAD || printf 'HEAD is detached\n'
printf 'keep this detached commit\n' > "$lab_path/detached.txt"
git -C "$lab_path" add detached.txt
git -C "$lab_path" commit -m "detached experiment"
git -C "$lab_path" branch keep-detached HEAD
git -C "$lab_path" switch main
A commit made while detached moves neither main nor agent/draft. keep-detached gives that commit a visible reference before returning to main.
verify.sh asserts the actual object IDs, reference resolution, and object types. Any failed assertion exits nonzero; the script does not merely print a fixed result. cleanup.sh removes only a directory marked for this lab and refuses the repository root, the user home directory, and the filesystem root.
Run the full self-test:
bash test.sh