gitlogue

gitlogue 是什么

gitlogue 是一款运行在终端里的 Git 提交回放工具，用电影化的动画方式重现你的提交历史。它会逐字「打字」展示代码变更，配合语法高亮、光标移动、删除操作和文件树切换，让代码演进过程变成一段可观看的故事。

项目使用 Rust 编写，基于 ratatui 构建 TUI 界面，并通过 Tree-sitter 实现多语言语法高亮。

主要特性

• 提交动画回放：模拟真实打字、光标移动、删除与文件操作
• 工作区差异视图：提交前可视化已暂存/未暂存的改动
• 语法高亮：基于 Tree-sitter，支持 32 种语言
• 项目文件树：展示目录结构及变更统计
• 屏幕保护模式：随机循环播放提交历史
• 主题系统：9 套内置主题，支持完全自定义
• 高性能：Rust 实现，启动快、资源占用低

快速上手

安装后直接运行即可进入电影式回放：

gitlogue

常用玩法示例：

# 查看指定提交
gitlogue --commit abc123

# 回放一段提交范围
gitlogue --commit HEAD~5..HEAD

# 按时间正序回放
gitlogue --order asc

# 循环播放某个提交
gitlogue --commit abc123 --loop

# 监听仓库，新提交产生时自动回放
gitlogue --watch

# 查看已暂存/未暂存的改动
gitlogue diff
gitlogue diff --unstaged

还支持按作者、日期过滤提交，调整打字速度，按文件类型设置不同速度，以及忽略特定文件模式：

gitlogue --author "john" --after "2024-01-01"
gitlogue --speed 20
gitlogue --speed-rule "*.java:50" --ignore "*.ipynb"

交互与配置

回放过程中可用 Space 播放/暂停，h/l 逐行前后移动，p/n 切换提交，Esc 打开菜单，q 退出。

默认配置位于 ~/.config/gitlogue/config.toml，可设置默认主题、打字速度和背景偏好。主题可通过 gitlogue theme list 查看、gitlogue theme set 设置。

注意事项

• 它不是真正的屏幕保护程序，不包含电源管理或息屏功能，只是视觉展示工具。
• 在 OLED 屏幕上长时间显示静态元素（如编辑器背景、边框）可能造成烧屏，LCD 屏幕一般无此问题。

适用人群

适合喜欢终端美化、需要做技术演示或教学、以及想用新颖方式回顾项目历史的开发者。