Zellij-Autolock 项目启动与配置教程

1. 项目目录结构及介绍

Zellij-Autolock 是一个为 Zellij 终端插件设计的自动锁定插件。以下是项目的目录结构及其组件的简要介绍：

• src/：源代码目录，包含 Rust 编写的插件逻辑。
• .cargo/：Cargo 配置文件目录，管理 Rust 项目的依赖和构建过程。
• .gitea/：Gitea 工作流配置目录，用于自动化处理项目的一些操作。
• .github/：GitHub 工作流配置目录，包含持续集成和持续部署（CI/CD）的配置。
• envrc：环境变量配置文件，用于设置插件运行时的环境变量。
• gitignore：Git 忽略文件列表，指定 Git 应该忽略的文件和目录。
• CHANGELOG.md：项目更新日志文件，记录项目的版本更新和更改。
• Cargo.lock：Cargo 锁文件，记录项目依赖的精确版本。
• Cargo.toml：Cargo 配置文件，定义项目的元数据和依赖。
• LICENSE：项目许可证文件，本项目采用 MIT 许可证。
• README.md：项目自述文件，提供项目的介绍和使用说明。
• renovate.json：Renovate 配置文件，用于自动更新依赖。
• rust-toolchain.toml：Rust 工具链配置文件，指定项目的 Rust 版本。

2. 项目的启动文件介绍

Zellij-Autolock 插件的核心启动文件是 src/main.rs，这是 Rust 项目的入口点。在这个文件中，编写了插件的初始化代码，包括监听 Zellij 事件的逻辑，并根据这些事件来决定是否锁定终端。

启动文件的主要功能包括：

• 初始化插件，注册事件监听器。
• 根据配置文件中的 triggers 设置，自动切换 Zellij 的锁定模式。
• 处理来自 Zellij 的事件，如 TabUpdate、PaneUpdate 和 InputReceived。

3. 项目的配置文件介绍

Zellij-Autolock 插件的配置文件是 config.kdl。这个文件用于设置插件的行为，如下：

• plugins：定义插件的位置和是否在启动时激活。
• triggers：指定一组命令，当这些命令在当前选项卡中运行时，会触发 Zellij 进入锁定模式。
• reaction_seconds：设置插件对输入事件的反应时间。
• print_to_log：设置是否将插件的活动记录到 Zellij 的日志文件中。

配置文件还定义了不同模式下键盘快捷键的绑定，包括 Normal 模式和 Locked 模式的快捷键，以及所有模式下共享的快捷键。

通过修改 config.kdl 文件，用户可以根据自己的需求调整插件的配置，以达到最佳的使用体验。