dotfiles-setup

用途：把机器配置纳入版本控制，并能在下一台 Mac 上一键恢复，同时避开两类常见故障：adopt/deploy 时覆盖正在使用的配置，以及首次提交就带入密钥。\n\n主要能力：选择管理器（chezmoi 默认，适合多机、工作/个人模板化、经 1Password/Keychain 管理密钥；GNU Stow 适合单机简单符号链接；bare git 无需额外工具）。创建流程包括 chezmoi init、add 现有文件、跟踪 Brewfile；提交前用 gitleaks 扫描密钥并补充 .gitignore。安全约束：部署前必须 diff，冲突文件先备份（mv X X.bak），绝不覆盖活动配置；~/.ssh/、~/.aws/、~/.kube/、.env*、*history、.netrc 不进入仓库。Bootstrap 脚本幂等且 fail-fast，检查 Homebrew 存在，不自行引导 Homebrew。\n\n使用方式：创建用 brew install chezmoi、chezmoi init、chezmoi add，恢复用 chezmoi init --apply <repo-url>（非全新机器先 chezmoi diff）；Stow 流程用 stow --simulate -v --target="$HOME" 预检，再 stow --target="$HOME" 实际链接，冲突需 diff 并做时间戳备份；Bare-git 用 git init --bare ~/.dotfiles.git 及 dot 别名。\n\n适用场景：新 Mac 恢复配置、多机同步、把 Brewfile 与 shell/git/config 纳入仓库。\n\n限制与注意：Stow 拒绝覆盖真实文件，不应使用 --override；符号链接的 .zshrc 在重装 Oh My Zsh 后需重新 stow；chezmoi 按设计是复制而非链接，编辑需经 chezmoi edit/re-add，否则会漂移。本技能不负责 .zshrc 内容（见 zsh-setup）、.gitconfig 内容（见 git-ssh-identity）、生成 Brewfile（见 homebrew-setup）、整机安装（见 macos-dev-setup）及数据备份（Time Machine，超出范围）。