lucky-commit

让你的 Git 提交变得幸运！

是什么？

这个简单的工具可以让你修改 Git 提交哈希的开始部分。

$ git log
1f6383a Some commit
$ lucky_commit
$ git log
0000000 Some commit

例如，查看这个仓库的最新提交。

如何使用？

lucky-commit 通过添加不同类型的空格字符修改你的提交消息，并不断尝试直到找到合适的哈希。默认情况下，它会寻找以 "0000000" 开头的提交哈希。

要查找不以 "0000000" 开头的哈希，请将所需的前缀作为命令行参数传递

$ lucky_commit 1010101
$ git log
1010101 Some commit

命令行参数还可以包含 _ 占位符（例如 lucky_commit 00_111），表示允许在给定的槽位中包含任何十六进制字符。

为什么？

¯\_(ツ)_/¯

安装

• 确保你已经安装了 rustc 和 cargo。安装说明可以在这里找到。
• 运行 cargo install lucky_commit --locked

根据你的 cargo 设置，这通常会将二进制文件添加到你的 $PATH。然后你可以通过运行 lucky_commit 来使用它。

或者，你可以从源代码构建

git clone https://github.com/not-an-aardvark/lucky-commit
cd lucky-commit/
cargo build --release

这将创建 lucky_commit 二进制文件（Windows 上为 lucky_commit.exe）在 target/release 目录中。你可以将其移动到任何位置，或者为其设置别名。

链接器错误的故障排除

默认情况下，lucky-commit 会与系统的 OpenCL 头文件链接，并在 GPU 上运行，这使得它运行速度更快。

然而，如果您遇到了类似以下链接错误的情况：/usr/bin/ld: cannot find -lOpenCL，这里有一些解决方案。

• 通过添加标志 --no-default-features 到您的安装或构建命令中，不使用 OpenCL 编译 lucky-commit（例如，cargo install lucky_commit --locked --no-default-features 或 cargo build --release --no-default-features）。这将使 lucky-commit 回退到多线程 CPU 实现。在我的笔记本电脑上，CPU 实现大约慢 20 倍，但根据您打算如何使用此工具，它可能已经足够快。

  如果您只需要一个稳定的构建，并且不需要 GPU 的额外性能，这是一个推荐的方法。

• 您可以尝试安装系统上的 OpenCL 库。具体说明将因操作系统而异（例如，请参阅此处）。请注意，这仅适用于您的机器有 GPU 的情况。

• 您可以尝试安装用不同语言编写的旧版库（例如，请参阅 Node.js、C 和 纯 Rust without OpenCL 分支）。请注意，这些旧版本比当前版本慢得多，并且也不再维护。

发行版软件包

Arch Linux

您可以使用 extra 仓库 使用 pacman 安装 lucky-commit。

pacman -S lucky-commit

Funtoo Linux

您可以从 dev-kit 安装 lucky-commit。

emerge dev-util/lucky-commit

Homebrew

lucky-commit 可从默认的 Homebrew tap 获取。

brew install lucky-commit

性能

lucky-commit 的性能取决于您的计算机有多强大，您是否对提交进行 GPG 签名，以及您是否使用实验性的 git 功能。

哈希率

lucky-commit 的主要瓶颈是 SHA1 的吞吐量。默认的哈希前缀为 0000000，长度为 7，因此平均而言，lucky-commit 需要计算 16⁷ 个 SHA1 哈希。

对于非 GPG 签名的提交，lucky-commit 将其空白字符添加到提交消息末尾的 64 字节对齐块中。由于任何特定提交之前的内容都是恒定的，这使得 lucky-commit 可以缓存 SHA1 缓冲区状态，并在每次尝试中仅哈希一个 64 字节块。对于平均大小的提交，这可以将搜索速度提高约 5 倍，超过每次尝试都哈希整个提交的原始方法。

哈希搜索可以高度并行化，而 lucky-commit 通过在 GPU 上运行来利用这一点。如果没有可用的 GPU，它将回退到多线程 CPU 实现。

我的2021年款MacBook Pro上的GPU每秒可以计算大约15亿个单块哈希。因此，在我笔记本电脑上找到0000000提交哈希的理论平均时间是（16⁷哈希）/（1500000000哈希/秒）= 0.18秒。您可以通过运行time lucky_commit --benchmark来估计您计算机的平均时间。

除了哈希之外，该工具还必须执行一定量的I/O操作（例如，多次启动git），因此我在笔记本电脑上观察到的平均时间约为0.24秒。

GPG签名

对于GPG签名的提交，提交信息是签名负载的一部分，因此lucky-commit不能编辑提交信息而不使签名无效。相反，它将空白添加到签名的末尾。由于签名在git的提交编码中位于提交信息之前，这要求lucky-commit在每次尝试时做更多工作（它不能有效地缓存SHA1缓冲区状态，并且每次都需要重新哈希提交信息）。因此，GPG签名提交的性能取决于提交信息的长度。这大约将平均搜索时间乘以1 + ceiling(提交信息长度 / 64 字节)。

SHA256存储库

最后，lucky-commit还支持使用实验性sha256对象格式的git存储库。如果lucky-commit检测到它正在sha256对象存储库中运行，它将自动定制HEAD处的提交sha256短哈希，而不是sha1短哈希。sha256的哈希率略慢于sha1的哈希率。

如果您想知道您的存储库是否使用sha256，那么它可能不是。在撰写本文时，这是一个高度实验性的功能，并且很少使用。

相关项目

• every-git-commit-shorthash