dotfiles/CHECKLIST.md

Dotfiles 迁移检查清单

用于新机器环境设置的完整检查清单

自动 = 脚本自动完成 | 手动 = 需要用户操作

---

📋 准备工作

• 手动 确认新 Mac 已登录 Apple ID
• 手动 安装 1Password (从 Mac App Store 或 1password.com)
• 手动 配置 1Password SSH Agent (System Settings → 1Password → Developer)

---

🚀 系统初始化 (自动)

运行：./setup.sh init

• 自动 Xcode Command Line Tools 安装
• 自动 Homebrew 安装
• 自动 zsh antigen 安装
• 自动 asdf 版本管理器安装
• 自动 创建必要目录 (~/.config, ~/.ssh, ~/.kube)
• 自动 macOS 偏好设置 (禁用长按字符弹出)

---

📦 Dotfiles 安装 (自动)

运行：./setup.sh install

• 自动 .zshrc 软链接
• 自动 .tmux.conf 软链接
• 自动 ~/.config/git 软链接
• 自动 ~/.config/nvim 软链接
• 自动 ~/.config/tmux 软链接
• 自动 ~/.config/wezterm 软链接
• 自动 ~/.config/starship.toml 软链接
• 自动 用 git/config 模板覆盖生成 ~/.gitconfig
• 自动 如不存在则用 ssh/example 初始化 ~/.ssh/config
• 自动 如可用则创建 ~/.1password/agent.sock 符号链接
• 自动 Git 全局配置 (excludesfile, defaultBranch)
• 自动 fzf 安装和配置

---

⚙️ 个人配置 (手动 - 重要!)

Git 配置

# 替换为你的真实信息
git config --file ~/.gitconfig user.name "Your Name"
git config --file ~/.gitconfig user.email "your@email.com"
git config --file ~/.gitconfig user.signingkey "your-ssh-public-key"

• 手动 配置 user.name
• 手动 配置 user.email
• 手动 配置 user.signingkey

SSH 密钥

# 生成新的 SSH 密钥
ssh-keygen -t ed25519 -C "your@email.com"

# 添加到 1Password SSH Agent
op ssh add ~/.ssh/id_ed25519

# 添加到 GitHub/GitLab
cat ~/.ssh/id_ed25519.pub | pbcopy
# 然后粘贴到 GitHub/GitLab 的 SSH Keys 设置

• 手动 生成 SSH 密钥
• 手动 添加密钥到 1Password
• 手动 添加公钥到代码托管平台
• 手动 按需调整 ~/.ssh/config 中的主机配置

验证 Git 配置

# 检查配置
git config --get user.name
git config --get user.email
git config --get user.signingkey

# 测试签名
git commit --allow-empty -m "Test signed commit"
git log -1 --format=full

• 手动 验证配置正确
• 手动 测试提交签名

---

🍺 Homebrew 包安装 (自动)

运行：brew bundle install

• 自动 安装 CLI 工具 (bat, ripgrep, fzf, lsd, difftastic, etc.)
• 自动 安装开发工具 (go, rustup, node, lua, luarocks, etc.)
• 自动 安装 Kubernetes 工具 (kubectl, helm, k9s, kubectx, etc.)
• 自动 安装数据库 (mysql, postgresql, redis, etc.)
• 自动 安装 Mac 应用 (1Password, Ghostty, WezTerm, Cursor, etc.)
• 自动 安装 VSCode 扩展
• 自动 安装 Go 工具 (golangci-lint, gopls, delve, etc.)
• 自动 安装 Cargo 工具 (sqlx-cli)

---

🔧 验证安装

Shell 环境

# 重启 shell 或运行
source ~/.zshrc

# 验证常用命令
which nvim tmux fzf bat rg lsd

• 手动 source ~/.zshrc 无错误
• 手动 验证 nvim 可用
• 手动 验证 tmux 可用
• 手动 验证常用 alias (l, la, lt, vi)

Neovim

# 打开 Neovim
nvim

# 首次启动会自动安装插件
# 等待插件安装完成
:Lazy

• 手动 Neovim 启动无错误
• 自动 lazy.nvim 自动安装插件
• 手动 验证 LSP 可用 (:LspInfo)
• 手动 验证 treesitter 可用

Kubernetes

# 验证 kubectl
kubectl version --client

# 验证 krew
kubectl krew version

# 验证常用工具
k9s version

• 手动 kubectl 可用
• 手动 k9s 可用
• 手动 配置 kubeconfig (工作相关)

---

🏢 工作环境 (可选)

如果你有特定的工作环境需求：

• 手动 配置 ~/.kube/config (工作集群)
• 手动 配置 rsync_work 目标服务器
• 手动 配置 git_config_work 邮箱
• 手动 配置其他工作特定 alias

---

✅ 最终检查

运行：./setup.sh check

• 自动 Homebrew 检查
• 自动 Zsh 检查
• 自动 Neovim 检查
• 自动 Tmux 检查
• 自动 Antigen 检查
• 自动 Symlinks 检查
• 自动 Git Config 检查

---

📝 后续步骤

• 手动 配置其他应用 (Raycast, Obsidian, etc.)
• 手动 同步浏览器书签/扩展
• 手动 配置工作专用软件
• 手动 测试常用工作流

---

🔍 故障排查

常见问题

1. zsh 配置不生效

   source ~/.zshrc
   # 或重启终端
   

2. Neovim 插件报错

   nvim --headless "+Lazy! sync" +qa
   

3. Homebrew 权限问题

   sudo chown -R $(whoami) $(brew --prefix)
   

4. Git 签名失败

   # 检查 1Password SSH agent
   ls -la ~/.1password/agent.sock
   op ssh list
   

---

📞 需要帮助？

• 查看 README.md 获取详细文档
• 查看 setup.sh --help 获取命令说明
• 查看 .sisyphus/plans/dotfiles-migration.md 获取计划详情

---

💾 离职前备份

运行备份脚本

cd ~/.dotfiles
./setup.sh backup

备份验证

• 自动 Brewfile 已更新
• 自动 SSH 公钥已备份到 ssh_backup_*/
• 自动 Git 配置摘要已导出
• 自动 1Password 配置已记录
• 自动 VSCode 扩展列表已导出
• 自动 备份报告已生成

提交备份

# 查看备份报告
cat .backup_report_*.md

# 提交安全文件
git status
git add Brewfile
git commit -m 'backup: pre-leaving dotfiles'
git push

清理敏感文件

# 确认敏感文件已被 .gitignore 排除
git status

# 手动清理（可选）
rm -f .git_config_summary.txt
rm -rf ssh_backup_*/
rm -f .1password_config.txt
rm -f .vscode_extensions.txt
rm -f .backup_report_*.md

备份检查清单

• 手动 确认 Brewfile 包含所有需要的包
• 手动 记录 SSH 公钥（用于新机器）
• 手动 备份 1Password 紧急工具包
• 手动 导出浏览器书签
• 手动 记录常用 Kubernetes 上下文
• 手动 备份其他个人配置文件