Git、GitHub 与备份

您刚装好一个会飞快写代码的 agent。在它碰任何要紧东西之前，我们先把网铺好：Git，让每一次改动都可回退；以及 GitHub，让您的工作活在这台小盒子之外的地方。因为一台迷你 PC 可能会烧掉、被偷，或者吃下一个多余的 rm。而您的代码，绝不该跟着一起消失。

为什么这事不容商量（尤其是有了 agent）

一个代码 agent 跑得快，而且很自信。多数时候这很棒；偶尔它会弄坏点什么。Git 把这变成一件无关紧要的小事：

• 每一次提交都是一个还原点。 agent 把一切都搞砸了？git restore 或 git reset，一秒钟您就回到了之前的状态。这是终极的「撤销」。
• 您能看清究竟改了什么。 git diff 一行一行地告诉您 agent 动了哪里。您在点头前先审一遍，这就是这门手艺的核心（见 保护访问安全）。
• GitHub 让您的代码远离灾难。 硬盘坏了、被偷了、误操作：您的代码在 GitHub 上，完好无损。您能在任何一台机器上用一条命令把它取回来。
• 而且您可以分享。 给同事开权限、多人协作、开源出去：全都经由 GitHub。

在机器上配置 Git

三行，一劳永逸。Git 需要知道您是谁（这会签署您的提交）：

git config --global user.name "您的姓名"
git config --global user.email "[email protected]"
# 几个明智的默认值
git config --global init.defaultBranch main   # 默认分支叫 "main"
git config --global pull.rebase false          # 可预期的 pull 行为

让机器获得访问 GitHub 的权限

您的机器得向 GitHub 证明它有权推送。两条路；选您顺眼的那条。

您的第一个仓库，以及用它的 agent

cd ~/mon-projet
git init
# 那个告诉 git 要忽略什么的文件, 至关重要
cat > .gitignore <<'EOF'
node_modules/
.env
*.log
dist/
EOF
git add -A
git commit -m "Premier jet"
# 创建远端仓库并推送（用 gh，一行就够）
gh repo create mon-projet --private --source=. --push

到位之后，让您的 agent 替您管 git：「定期提交，写清晰的提交信息」「为这个功能创建一个分支」「开一个 pull request」。您甚至可以把它写进您的 记忆文件：「每一步验证通过后提交，使用约定式的提交信息，未经我同意不要推到 main。」

备份：3-2-1 法则

GitHub 保住了您的代码。但您的迷你 PC 里还装着许多不在 git 里的东西：您的 .env 文件、您的数据库、生成的数据、系统配置。对这些，我们套用备份的黄金法则：

三个只有在恢复时才会发现的陷阱

用卷标定位磁盘，永远不要用路径

外置硬盘不一定每次都挂在同一个地方。如果目录已经存在，桌面环境会加一个数字，挂到 /media/您/1TB1，把 /media/您/1TB 留在原地，变成系统盘上的一个空目录。

天真的 [ -d "$DEST" ] 判断照样通过。于是您的备份安安静静地写进了系统盘，还以为自己写在外置盘上。

# 用卷标解析，并且要求它必须是一个真正的挂载点
DEST="$(findmnt -rn -S LABEL=1TB -o TARGET 2>/dev/null | head -1)"
[ -n "$DEST" ] && mountpoint -q "$DEST" \
  || { echo "外置 SSD 未挂载，备份中止"; exit 1; }

写死的清单会漏掉新来的

一个手工罗列数据库的脚本，永远不会备份您上个月新建的那个项目。而且它不会吭声。请扫描真正在跑的东西：

for c in $(docker ps --format '{{.Names}}'); do
  # 探测工具是否存在，而不是去匹配镜像名：
  # 这样连 pgvector、timescaledb 之类的衍生版也能一并抓到
  docker exec "$c" sh -c 'command -v pg_dumpall' >/dev/null 2>&1 || continue
  docker exec "$c" pg_dumpall -U postgres | gzip > "$DEST/$c.sql.gz"
done

破坏性重建必须是原子的

一个先删库再重建的脚本，万一中途挂掉，您手上就什么都不剩了。请在旁边建好，然后改名：在同一个文件系统内，改名是原子操作。

sqlite3 base.sqlite.tmp < schema.sql
# … 填充 …
mv base.sqlite.tmp base.sqlite      # 要么瞬间切换，要么什么都不发生

切换之前还要核对：完整性、索引数量、行数下限。否则一次只完成了一半的重建，看上去也像成功。