dotfiles

使用 GNU Stow 集中管理个人开发环境与 AI 工具配置

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:dotfiles。
它的用途是:使用 GNU Stow 集中管理个人开发环境与 AI 工具配置
详细介绍见:https://321skill.com/skills/dotfiles-bphkns/
请根据该页面的说明完成安装。

使用示例

“我的新电脑系统装好了,帮我把常用的开发环境和AI工具配置快速部署好。”,它会引导你克隆这个 dotfiles 仓库,运行安装脚本,将预先定义好的 Neovim、Zsh、Mise、Claude 等配置一键链接到你的 home 目录下。接着,你可以运行 `mise install` 安装所有开发工具,并执行 `./setup-ai-skills.sh` 来获取配置好的 AI 技能。

介绍

这个 Skill 旨在解决开发者和技术爱好者因使用多台机器或频繁重装系统时,个人配置文件(dotfiles)分散、难以同步和迁移的问题。它通过 GNU Stow 这一符号链接管理工具,将终端、编辑器、Shell、窗口管理器乃至 AI 工具等数十种应用的配置文件集中在一个仓库中,实现一键式链接部署。

使用时,用户只需克隆仓库并运行安装脚本,即可将预设的配置(如 Neovim、Zsh、Hyprland、Mise、Claude 等)以符号链接的形式快速部署到系统对应目录。安装脚本支持模拟运行、备份冲突文件,并允许选择性安装特定应用的配置,提供了极大的灵活性。

它非常适合追求高效、一致且可移植开发环境的全栈开发者、运维工程师以及热衷于定制化工作流的 AI 工具使用者。对于需要在多台设备(如个人笔记本与工作站)间保持环境统一的用户尤其有价值。

需要注意的是,此配置集高度个性化,直接全量安装可能与用户现有配置冲突。建议先进行模拟运行检查冲突,或仅安装所需部分。此外,其中包含针对特定硬件(如旧款 Lenovo Yoga)的配置,在新设备上使用前需仔细甄别。敏感信息如密钥、令牌等均通过外部私有文件管理,不会被纳入仓库。

核心特点

与同类 dotfiles 管理方案相比,它深度集成了包括 Claude、Codex 在内的多种 AI 工具配置,并提供了专门的 AI Skills 管理脚本;同时,它严格采用 GNU Stow 的 `--no-folding` 模式,允许本地状态文件与管理的符号链接安全共存,而非覆盖整个配置目录。

注意事项

不适合希望开箱即用、不愿深度定制或对 GNU Stow 及 Linux 环境不熟悉的初学者。

常见问题

安装会覆盖我现有的配置文件吗?

不会直接覆盖。安装脚本提供 `--backup` 选项,会将冲突的现有文件移动到备份目录,然后用符号链接替换。

如何只安装我需要的部分配置(比如只装 Neovim 和 Zsh)?

运行 `./install.sh --backup nvim zsh` 即可,在命令后列出需要的包名。