lumen

终端里看 diff、写提交，AI 帮你搞定

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 164 🐛 待处理 78 👀 关注 6

GitHub ↗

GitHub 星标 ★ 2910

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，无付费版本。

项目预览

项目数据

分类开源模型

开发团队jnsahaj

GitHubhttps://github.com/jnsahaj/lumen

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型cli,commit,git,llm,openai,rust

GitHub 星标★ 2910

上线时间2024-10-28 00:00:00

代码更新2026-09-17

仓库体积577 KB

本站数据更新2026-11-07

维护状态维护中

收录时间2026-08-09

浏览次数6

项目介绍

lumen 是一个用 Rust 编写的命令行工具，旨在提供美观的 git diff 查看体验，并集成 AI 能力来辅助生成提交信息和总结代码变更。它解决了传统 git diff 输出难以阅读、提交信息撰写耗时的问题。核心能力包括：以高亮和分栏方式清晰展示代码差异，支持通过 AI 自动生成符合规范的 commit message，以及快速获取变更摘要。该工具完全在终端中运行，无需离开命令行环境，适合开发者日常使用。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2910

技术标签

cli git llm openai rust

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 10 分钟部署方式：命令行工具 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

git 仓库（也支持 Jujutsu/jj）
可运行 TUI 的终端环境
使用 AI 功能需准备 OpenAI 等提供商的 API Key
全局配置需可写入 ~/.config/lumen/ 目录

安装与启动步骤

1安装 lumen

README 的 Installation 章节未给出具体安装命令，请到仓库页面按对应平台说明安装；它是以单个静态 Rust 二进制形式发布的。
2交互式配置 AI

运行后在提示中依次选择 AI 提供商、填写 API Key 和模型名，设置会保存到全局配置文件。
```
lumen configure
```
3查看代码差异

在仓库中查看 git diff；也可直接评审 GitHub PR，把编号换成目标 PR 的编号。
```
lumen diff --pr 123
```
4生成提交信息

先 git add 暂存改动，再执行该命令，lumen 会依据暂存内容生成符合规范的 commit message。
```
lumen draft
```
5用配置文件固化设置

可选：在项目根目录创建 lumen.config.json，写入提供商、模型、密钥与主题等；优先级低于命令行参数。
```
{
  "provider": "openai",
  "model": "gpt-5-mini",
  "api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "theme": "catppuccin-mocha",
  "wrap": true
}
```

关键配置

配置项	必填	说明	示例
`provider`	是	指定使用的 AI 提供商，如 openai	`openai`
`model`	是	指定调用的模型名称	`gpt-5-mini`
`api_key`	是	提供商的 API 密钥，用于调用 AI 功能	`sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
`theme`	否	diff 查看器的配色主题	`catppuccin-mocha`
`wrap`	否	是否自动换行长文本行	`true`
`draft.commit_types`	否	自定义提交信息使用的提交类型及说明	`{"feat":"A new feature","fix":"A bug fix"}`