SuperAPI AI 工具集

managing-dotfiles

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:用 GNU Stow 这一符号链接农场管理器,管理 ~/.claude/dotfiles/ 中跟踪的 dotfiles,按包把目录结构镜像到 $HOME。

目录约定:每个包内部结构对应家目录,例如 dotfiles/tmux/.config/tmux/tmux.conf 对应 ~/.config/tmux/tmux.conf,dotfiles/git/.gitconfig 对应 ~/.gitconfig。包名只是组织标签,实际由内部目录结构决定链接落点。

新增包三步:先建包目录 mkdir -p ~/.claude/dotfiles/<pkg>/<path-relative-to-home>,再把现有配置移入,然后执行 stow -d ~/.claude/dotfiles -t ~ <pkg>。

常用命令:装载 stow -d ~/.claude/dotfiles -t ~ <pkg>;卸载加 -D;重构后重装用 -R;预演用 -n -v;一次装载全部用 make dotfiles。安装 Stow:macOS 用 brew install stow,Debian/Ubuntu 用 apt install stow,Fedora/RHEL 用 dnf install stow。

故障处理:目标已存在真实文件时 Stow 不覆盖,可用 --adopt 把现有文件并入包再 stow,但该选项会用目标文件替换包内文件,若包内版本更新应先备份或用 git diff 检查;同一目标被两个包占用时用 ls -la 查看归属后删除重复;Stow 默认树折叠,若只属于一个包会直接链接目录,需要文件级链接时加 --no-folding。