lumen

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

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

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2870

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队jnsahaj

所属国家

官网地址

GitHubhttps://github.com/jnsahaj/lumen

定价模式free

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

访问状态

是否开源是

开源协议MIT

主要语言Rust

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

GitHub 星标★ 2870

30天Star增速

HF 下载量

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

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 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"}`

如何确认成功

在暂存了改动的仓库中执行 lumen draft，能输出 AI 生成的提交信息，即说明配置成功。

常见问题

Q：README 里没写安装命令怎么办？

A：请以仓库 Installation 章节和 Releases 页面为准；lumen 以单个静态二进制分发，按你所在平台选择对应方式安装即可。

Q：配置文件应该放在哪里？

A：三个位置任选：项目根目录的 lumen.config.json、用 --config 指定的自定义路径、全局目录（Linux/macOS 为 ~/.config/lumen/lumen.config.json）。

Q：多个项目要用不同提供商怎么配？

A：在各项目根目录分别放 lumen.config.json 写入不同 provider，或在运行时用 CLI 参数覆盖文件配置。

Q：不用 AI 功能可以吗？

A：可以。AI 提交信息与变更解释是可选能力，纯 diff 查看、分支与 PR 评审不需要 API Key。

注意事项

配置优先级从高到低为：CLI 参数 > --config 指定的文件 > 项目根目录 lumen.config.json > 全局配置文件。
Windows 全局配置路径为 %USERPROFILE%.configlumenlumen.config.json。
lumen 同时支持 Git 和 Jujutsu（jj）仓库。
README 节选中未提供安装命令与具体端口/路径参数，请勿自行臆造。

核心亮点

美观的 diff 渲染，支持语法高亮和分栏对比，提升代码审查效率
集成 AI 自动生成 commit message，减少手动撰写时间
纯 Rust 实现，性能好，安装简单，无运行时依赖

不足之处

AI 功能需要额外配置 API 密钥，可能增加使用门槛
文档/社区待观察

适用场景

日常 git 提交时快速生成规范的 commit message
代码审查时清晰查看 diff 变更
在终端环境中快速了解代码改动摘要

替代项目

diff-so-fancy、delta、git-ai

项目介绍

lumen 是编程开发领域的开源项目，由 jnsahaj 开发，2024 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（2,870）位列前 30%，在编程开发分类中处于中上游。

近 42 天，它的 GitHub 星标从 2,732 增加到 2,870，净增 138。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。MIT许可证，完全免费，无付费版本。

它主要面向的使用场景是：日常git提交时快速生成规范的commitmessage。同类可对比的替代方案包括 diff-so-fancy、delta、git-ai。

上一篇：lsp-ai

下一篇：aide