dotfiles

基于 Zsh + Zinit + LazyVim 的终端配置方案，追求极致的启动速度与沉浸式开发体验。

快速开始

第一步：克隆仓库

git clone https://github.com/iamcheyan/dotfiles ~/dotfiles
cd ~/dotfiles

第二步：运行初始化脚本

bash init.sh              # 完整安装（推荐）
bash init.sh --minimal    # 轻量安装（跳过字体、Neovim 等）
bash init.sh --repair     # 修复损坏的 zinit 插件

初始化脚本会自动完成以下操作：

• 安装 Zsh 并设置为默认 Shell
• 安装所有必备工具（git, curl, ripgrep, fd, bat, lsd, zoxide 等）
• 安装 zinit 插件管理器
• 安装 pyenv（Python 版本管理）
• 安装 fnm（Fast Node Manager）
• 安装 fzf（模糊搜索）
• 安装 direnv（目录级环境变量）
• 创建配置文件符号链接
• 安装 Neovim + LazyVim
• 安装 Nerd Font 字体
• 初始化 Yazi 文件管理器配置
• 安装 Zellij、Codex、Opencode 等额外工具

第三步：启动 Zsh

zsh

首次启动会自动安装 Powerlevel10k 主题和所有插件。

核心组件

组件	说明
Shell	Zsh + Powerlevel10k
插件管理	Zinit（异步加载，极速启动）
Vim 模式	zsh-vi-mode
历史搜索	Atuin（Ctrl+R）
编辑器	Neovim（LazyVim）
文件管理	Yazi
终端多路复用	Zellij
终端模拟器	Kitty / Ghostty

工具链替换

我们用更现代的工具替换了传统命令：

原命令	替换工具	说明
ls	eza	带颜色和图标的目录列表
cat	bat	带语法高亮的文件查看
find	fd	更快的文件查找
du	dust	更直观的磁盘使用分析
grep	ripgrep	极速文本搜索
top	btop	美化的系统监控
ps	procs	更友好的进程查看
cd	zoxide	智能目录跳转（记住历史路径）

AI Agent 集成

我们提供了一键切换 AI Agent 账户的脚本，支持多个 AI 编码助手：

cc 脚本（Claude Code 启动器）

Claude Code 的封装脚本，支持多 provider/model 切换、会话恢复、非交互模式等。详见 CC.md。

cc                          # 启动 Claude Code
cc <provider>               # 使用指定 provider
cc <provider> <model>       # 使用指定 provider + model
cc -s                       # 交互式选择 model
cc -c                       # 继续上次对话
cc -r                       # 恢复历史对话
cc -p "prompt"              # 非交互模式

cx 脚本（通用 Agent 切换）

cx              # 切换 Agent 账户
cx --list       # 列出所有配置的账户

支持的 Agent

Agent	说明
app:claude-code	Claude Code
app:opencode	OpenCode
app:codex	Codex

所有 Agent 通过统一的 API 接入，使用独立的 Node.js 版本隔离运行。

LazyVim 插件列表

我们基于 LazyVim 搭建了 Neovim 配置，安装了以下插件：

插件	功能
aerial	代码大纲/导航（类似 VS Code 面包屑）
auto-session	自动保存/恢复会话
bufferline	顶部标签栏
ccc	颜色预览/编辑器
colorscheme	配色方案
dashboard	启动页面
dev-visual	开发可视化工具
disable-diagnostics	禁用诊断显示
flash	快速跳转（类似 Hop/Sneak）
heirline	状态栏/窗口栏
icons	图标支持
lsp-keymaps	LSP 快捷键
muren	多重替换
neo-tree	文件浏览器
noice	命令行/通知美化（已禁用）
oil	文件浏览器（轻量）
persistence	会话持久化
python	Python 开发支持
snacks	LazyVim 核心功能集
spectre	全局搜索替换
telescope	模糊搜索
toggleterm	终端集成
vim-visual-multi	多光标编辑
which-key	快捷键提示
yanky-substitute	复制/粘贴增强
yazi	终端文件管理器

目录结构

dotfiles/
├── zshrc                 # Zsh 主配置
├── aliases.conf          # 命令别名
├── init.sh               # 初始化脚本
├── dotlink/              # 符号链接管理
│   ├── dotlink           # 链接创建/管理
│   ├── dotsync           # 同步编排
│   └── dotlinkrc         # 链接配置
├── plugins/              # Zinit 插件配置
│   ├── zinit/            # Zinit 管理器
│   ├── prompt/           # Powerlevel10k 主题
│   ├── tools/            # CLI 工具
│   ├── completion/       # 补全配置
│   ├── yazi/             # Yazi 集成
│   ├── fzf/              # fzf 配置
│   ├── zellij/           # Zellij 集成
│   └── zsh-vi-mode/      # Vim 模式
├── config/               # 应用配置
│   ├── nvim/             # Neovim (LazyVim)
│   ├── yazi/             # Yazi
│   ├── kitty/            # Kitty 终端
│   ├── ghostty/          # Ghostty 终端
│   ├── zellij/           # Zellij
│   └── atuin/            # Atuin 历史搜索
├── scripts/              # 自动化脚本
│   ├── install/          # 安装脚本
│   ├── dev/              # 开发工具
│   └── system/           # 系统工具
├── tools/                # 独立工具脚本
├── agent/                # Agent 脚本（cc/cx/opencode 等）
├── documents/            # 文档/笔记
└── rime/                 # Rime 输入法配置

日常命令

命令	说明
dotlink	链接配置文件到 $HOME
dotsync	同步配置（备份/推送/恢复）
dp	推送 dotfiles 到远程
reload	重载 zsh 配置

常用快捷键

Zsh（Vim 模式）

按键	说明
Ctrl+R	历史命令搜索（Atuin）
;;	切换输入法（SBZR）
j/k	历史命令搜索（上/下）

Neovim

按键	说明
<leader>e	文件浏览器
<leader>ff	模糊搜索文件
<leader>fg	模糊搜索内容
<leader>gg	Git 状态
<leader>xx	诊断列表
gcc	注释/取消注释行
gc	注释/取消注释选中区域

自定义配置

添加新插件

在 ~/.config/nvim/lua/plugins/ 目录下创建新的 .lua 文件：

return {
  {
    "author/plugin-name",
    config = function()
      -- 插件配置
    end,
  },
}

修改别名

编辑 ~/dotfiles/aliases.conf，添加你的自定义别名：

alias mycommand="original-command"

然后运行 reload 使配置生效。

故障排除

Zinit 插件损坏

bash init.sh --repair

重新创建符号链接

dotlink link

重置 Neovim 配置

rm -rf ~/.config/nvim
dotlink link

许可证

MIT License