个人 Neovim 配置，面向 Neovim 0.13-dev Nightly，追求轻量、可读、易维护。核心功能栈用 mini.nvim 拼起来，插件管理用 Neovim 原生的 vim.pack.add，不引入 lazy.nvim / packer 之类的外部管理器。
最初的组织方式受 theniceboy/nvim 启发。
- 声明式插件列表：所有插件在
init.lua里用vim.pack.add()一次性列出，版本靠nvim-pack-lock.json锁定。 - 模块化：每个文件只负责一件事，按「核心配置 / 插件配置 / 自定义组件 / 独立小工具 / 横向工具」分层存放。
- 启动性能优先：LSP 和重插件放进
config/deferred.lua，在VimEnter/FileType时才加载；telescope、codecompanion、markdown 插件只安装不加载，首次使用时再packadd（见utils/lazy.lua）。 - 自己动手：statusline、tabline、浮动终端（floatty）都是自研的，不依赖 lualine / toggleterm 等成熟插件。
init.lua # 入口：加载顺序 + vim.pack.add 插件清单
lua/
├── config/ # 核心配置（与「用什么插件」无关的部分）
│ ├── base.lua # vim.opt 选项、shell、环境变量
│ ├── keymaps.lua # 全局键位、mapleader 定义
│ ├── autocmds.lua # 原生 autocmd
│ ├── lsp.lua # 诊断 UI + vim.lsp.enable() 服务列表
│ ├── deferred.lua # VimEnter/FileType 触发的延迟加载
│ ├── floatty.lua # Floatty 应用列表/快捷键/Runner/窗口参数
│ ├── neovide.lua # 仅 Neovide 客户端生效的设置
│ └── local.lua.example # 本机专属配置（代理等）模板，真实文件已 gitignore
├── plugins/ # 插件的具体配置（插件已注册后加载）
│ ├── mini.lua # mini.nvim 各模块：补全/文件树/git/图标/代码片段…
│ ├── ui.lua # notify、which-key、原生 UI2
│ ├── telescope.lua # 搜索快捷键与最近仓库入口（按需加载）
│ ├── theme.lua # catppuccin 配色与高亮覆盖
│ ├── editor.lua # treesitter、匹配、缩进高亮
│ └── llm/ # AI 工具：codecompanion（deepseek 适配器）
├── component/ # 自定义 UI 组件
│ ├── statusline.lua # 状态栏
│ ├── tabline.lua # 标签页栏
│ ├── stldata.lua # git/lsp/diagnostic → 状态栏用的纯数据
│ ├── hl.lua # statusline/tabline 共用的高亮 & 文件图标辅助
│ └── profiler.lua # statusline 耗时统计（:StlProf on/off）
├── apps/ # 自成一体的独立功能；require 无副作用，统一由 init.lua 调 setup()
│ ├── floatty/ # 浮动终端/窗口管理器（终端/Lazygit/AI 聊天/Runner）
│ │ ├── init.lua # setup()（keymap/autocmd）、statusline_segment()
│ │ ├── controller.lua # 终端生命周期：toggle / pick / idle 关闭
│ │ ├── registry.lua # 持久会话注册表（孤儿会话续接）
│ │ ├── claude.lua # Claude Code 会话元数据 watcher
│ │ └── pulse.lua # busy 时的呼吸边框
│ ├── proctop.lua # 子进程 CPU/内存监视器 (<D-p> / :ProcTop)
│ ├── recent_repos.lua # 最近 Git 仓库 frecency 排序 + Telescope picker
│ └── zoom.lua # 窗口最大化/恢复 (<D-f>)
└── utils/ # 被其他模块 require 的横向工具
├── map.lua # 键位映射封装（macOS <D-key>、全角标点转换）
├── lazy.lua # 按需加载：once() / on_cmd() 命令 stub
└── json_store.lua # 小型 JSON 文件安全读写（原子写入）
lsp/ # 每个 LSP 一个文件，由 config/lsp.lua 统一 enable
ftplugin/ # 按文件类型加载的设置
snippets/ # mini.snippets 用的 JSON 代码片段
在 init.lua 中用 vim.pack.add() 声明式列出：
vim.pack.add({
{ src = "https://github.com/...", version = "v0.2.0" }, -- 锁定版本（spec 只认 src/name/version/data）
"https://github.com/...", -- 简单 URL
})
-- 只安装不加载（注意 load = false 等同 :packadd!，启动时仍会 source plugin/）
vim.pack.add({ "https://github.com/..." }, { load = function() end })构建步骤（make、:TSUpdate）写在 init.lua 的 pack_builds 表里，由 PackChanged 钩子在安装/更新时执行。
nvim-pack-lock.json 记录实际锁定的 commit，跨机器同步时以它为准；改动插件版本时记得同步更新。
| 分类 | 插件 |
|---|---|
| 基础库 | mini.nvim、plenary.nvim、sqlite.lua |
| UI/外观 | catppuccin、which-key.nvim、nvim-notify |
| 搜索 | telescope.nvim + telescope-fzf-native.nvim |
| 语法 | nvim-treesitter、nvim-treesitter-context、nvim-ts-autotag |
| 编辑增强 | wildfire.nvim、hlchunk.nvim、undotree、nvim-neoclip.lua |
| AI | codecompanion.nvim（按需加载） |
| 语言工具安装 | mason.nvim（首次 :Mason* 时 setup） |
| Markdown | render-markdown.nvim、bullets.nvim（首个 markdown buffer 时加载） |
| 性能 | faster.nvim（大文件优化） |
DAP 遗留配置已移除；Mason 和 CodeCompanion 保留。
一个插件顶多个：completion（补全）、pairs/surround（括号/包裹）、diff + git（Git 集成）、files（文件树）、icons（图标）、cursorword（光标高亮同名词）、hipatterns（颜色高亮）、snippets（代码片段）、keymap（多步按键映射，如 <Tab> 复用于补全/跳转）。详细配置见 lua/plugins/mini.lua。
lua/config/lsp.lua 统一配置诊断 UI 并 vim.lsp.enable() 以下服务，具体行为在 lsp/<name>.lua 中：
lua_ls、stylua、ty、ruff、basedpyright、taplo、rust_analyzer、vtsls、biome、bashls、nushell、markdown_oxide、docker_language_server
服务器本身通过 Mason 安装（:MasonInstall），配置未设置 ensure_installed，需要手动装一次。
Leader 是 <space>（vim.g.mapleader），完整定义看 lua/config/keymaps.lua。macOS <D-key>（Command 键）由 lua/utils/map.lua 统一处理。
| 按键 | 功能 |
|---|---|
<D-g> |
Floatty：浮动终端 |
<D-i> |
Floatty：Lazygit |
<D-e> |
Floatty：AI 聊天 / Shell 菜单（Codex / Claude / Shell），<M-e> 打开选择器 |
<D-r> |
Floatty：Runner，按文件类型自动执行（RUNNERS 表：python → uv run、rust → cargo run…） |
<D-b> |
打开侧边文件树（mini.files） |
<D-o> |
CodeCompanion AI 聊天 |
<D-p> |
ProcTop 子进程监视器 |
<D-f> |
放大/恢复当前窗口 |
<leader>h / <leader>rn / <leader>, |
LSP：悬浮提示 / 重命名 / 代码操作 |
<D-S-f> |
格式化当前文件 |
- Neovim 0.13-dev Nightly（依赖原生
vim.pack、vim._core.ui2等） - 主力在 macOS 上开发，默认 shell 为 nu (Nushell)
- 完整的外部命令行工具清单（按必需/推荐/可选分级，含跨平台迁移注意事项）见 DEPENDENCIES.md
# 1. 备份原有配置
mv ~/.config/nvim ~/.config/nvim.bak
# 2. 克隆本仓库
git clone <repo-url> ~/.config/nvim
# 3. 启动 Neovim，vim.pack.add 会自动拉取插件
nvim首次启动后按 DEPENDENCIES.md 补齐系统级工具，再用 :MasonInstall 装齐 LSP。
| 想改什么 | 去哪 |
|---|---|
| 键位 | lua/config/keymaps.lua |
| Vim 选项 / shell / 环境变量 | lua/config/base.lua |
| 新增插件 | init.lua 的 vim.pack.add() → 按需在 lua/plugins/ 建配置文件 → init.lua 底部 require() |
| 新语言 LSP | 新建 lsp/<name>.lua → config/lsp.lua 里 vim.lsp.enable() 加进去 → 按需在 ftplugin/ 补充 |
| 状态栏 / 标签栏 | lua/component/statusline.lua / tabline.lua |
| Floatty 应用 / 快捷键 / Runner / 窗口 / 动画 | lua/config/floatty.lua |
| Floatty 终端生命周期 | lua/apps/floatty/controller.lua |
| Floatty 快捷键注册 / 状态栏片段 | lua/apps/floatty/init.lua |
| Floatty 会话注册表和缓存 | lua/apps/floatty/registry.lua |
| 新增独立小工具 | lua/apps/<name>.lua 导出 setup() → 加进 init.lua 的 apps 列表 |
修改后重启 Neovim 验证（不做部分 source 重载）。出问题看 :messages 或 :checkhealth。
- Neovim 官方文档
- 更详细的架构说明见仓库内 CLAUDE.md
- Floatty 的常改参数集中在
lua/config/floatty.lua，保持原有应用顺序与快捷键。apps配置会复制后使用，运行状态不会写回配置表。 - 应用可设置
key、pick_key、cmd、shell、w、h、idle_ttl_ms；AI 菜单通过choices配置，Claude 配置目录使用claude.dir。 - 全局窗口默认值在
window，呼吸边框在pulse（enabled、period_s、interval_ms），成功退出关窗延迟为autoclose_ms。 - 状态栏读取缓存；注册表在启动、会话操作、焦点恢复和目录变化时刷新。仍沿用共享 JSON 和最近会话恢复机制，多实例事务与精确会话恢复尚未改动。
- 修改配置后重启 Neovim，不再保存
init.lua/base.lua时自动部分重载。临时⌘N状态栏调试键已移除；:StlProf on、:StlProf、:StlProf off保留。
<leader>fr：选择仓库后新建标签页，以tcd设置项目目录，并打开 mini.files；不再自动恢复 Session 或猜测入口文件。目录失效时提示，不改变当前工作区。- 仓库列表中
Ctrl-R修改别名，Ctrl-D仅移除历史记录，不删除目录。 - 排序以有效访问天数为主：同一仓库每天最多计一次，重启也不会重复累计。分数为
log2(1 + 访问天数) + 近期加分；近期加分最高 1 分，30 天减半，避免偶尔打开的项目轻易超过常用项目。 - 仅接受当前记录结构（
path、days、last、可选alias），不迁移旧记录；旧仓库和别名需重新积累或设置。频率基分长期保留，不使用的历史可手动移除。 ⌘F放大窗口按标签页独立管理；窗口大小随界面调整，关闭时将阅读位置同步回仍显示同一 buffer 的来源窗口。
statusline.lua负责展示，tabline.lua负责标签和布局，stldata.lua统一维护诊断、Git 用户与 LSP 进度；util.lua只提供文本截断、转义和重绘合并。- Tab 标签跟随最近的普通编辑窗口；Floatty、Telescope、mini.files 等浮窗不替换文件名。项目名使用 tab 的工作目录。
- 窄窗口优先保留当前 tab，必要时隐藏项目标题、缩短文件名和省略装饰；中文按显示宽度截断。
- 诊断事件即时更新缓存，两条栏共用。重绘请求在同一轮事件中合并，不再额外监听光标移动或启动诊断防抖定时器。
- Git 用户名异步读取
git config --get user.name，支持 worktree / includeIf；切回 Neovide 时刷新已打开仓库的用户名。渲染函数不读取配置文件或启动进程。 - LSP 进度显示最早开始的活跃任务，保留 report 中未提供的字段，客户端停止后不再显示；动画帧按时间计算，在界面重绘时更新，没有常驻动画定时器。
- 临时评测：
:StlProf reset→:StlProf on→ 正常编辑/切 tab →:StlProf off→:StlProf。显示两条栏完整 Lua render 的调用数、最近 200 次的平均/P95/最大耗时；不包含 Neovim 绘制或 Neovide 呈现耗时。