ressession.nvim 使用手册

1. 项目目录结构及介绍

resession.nvim 是一个针对 Neovim 的会话管理插件，提供更灵活和定制化的会话保存与恢复功能。以下是该插件的基本目录结构及其简介：

• .gitignore: 忽略文件配置。
• CHANGELOG.md: 版本更新日志。
• LICENSE: 插件使用的MIT许可协议文件。
• Makefile: 构建或自动化任务脚本。
• lua/resession.lua: 核心逻辑实现文件，是插件的主要代码部分。
• scripts: 可能包含一些辅助脚本或自动化工具。
• stylua.toml: Stylua的配置文件，用于Lua代码风格统一。
• test: 测试相关文件夹，确保插件功能的正确性。
• doc: 文档目录，尽管这里没有具体列出，但通常包括帮助文档，对于Neovim插件来说，这很重要，它会在:h resession命令时显示。

2. 项目的启动文件介绍

在Neovim中，不需要直接操作resession.nvim的任何启动文件来使用该插件。安装完毕后，通过配置你的init.vim或.vimrc文件来激活和设定resession.nvim。以下是一个简单的示例，展示了如何在你的配置文件中设置resession.nvim以进行基本的自动保存和加载会话：

local resession = require("resession")
resession.setup()
-- 自动保存会话
vim.api.nvim_create_autocmd("VimLeavePre", { callback = function() resession.save("last") end })
-- 自动加载上一次的会话
vim.api.nvim_create_autocmd("VimEnter", { callback = function() resession.load("last") end })

这里的启动逻辑通过自定义命令绑定或自动命令（autocommands）来实现，使得插件在特定事件（如退出或进入编辑器）时自动执行操作。

3. 项目的配置文件介绍

虽然resession.nvim本身不直接使用外部配置文件，其配置是通过调用require("resession").setup{...}函数并在其中传递配置表来进行的。下面是一些关键配置选项的例子：

require("resession").setup({
    -- 自动保存设置
    autosave = {
        enabled = true,
        interval = 60, -- 每隔60秒自动保存一次会话
        notify = true, -- 是否通知自动保存成功
    },
    
    -- 存储会话的目录，默认是"session"
    dir = "session",
    
    -- 决定哪些缓冲区应被保存的标准过滤器，默认已定义
    buf_filter = require("resession").default_buf_filter,
    
    -- 为支持扩展做准备，允许添加更多的行为到会话处理流程中
    extensions = {
        -- 示例：如果要使用与resession集成的额外功能扩展
        quickfix = [],
        -- 或者自定义扩展
    },
    
    -- 更多的配置项可根据官方文档进一步定制
})

上述配置演示了如何设置自动保存间隔、通知以及指定存储会话的默认目录等。此外，resession.nvim还提供了对更多细节的控制，比如选择性地保存某些缓冲区，支持tab-scoped会话，以及通过扩展增加额外的功能等。确保查看官方GitHub仓库的README以获取完整的配置选项和详细说明。