From 8da670ca14492a3066e539b5c5847c9214594773 Mon Sep 17 00:00:00 2001 From: JianFeeeee Date: Tue, 29 Sep 2026 17:09:02 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E7=94=A8=20.mailmap=20=E5=BD=92?= =?UTF-8?q?=E5=B9=B6=E8=99=9A=E6=8B=9F=E8=B4=A1=E7=8C=AE=E8=80=85=E8=BA=AB?= =?UTF-8?q?=E4=BB=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit GitHub 的 Contributors 列表按**提交邮箱**归并身份，而本项目历史里同一个人的提交来自 多个邮箱（本地 root、个人 QQ、gitcode noreply、GitHub noreply、dev@local 等）， 于是列表里冒出 5 个并不存在的「协作者」： root@qq.com(135) / root@qq.com(51) / 2198972886@qq.com(33+4) dev@local(14) / root@minecraft-server(10) / 109188060+JianFeeeee@...noreply(19) 加上真实身份，7 条里只有 1 条是人。 .mailmap 只影响**展示层**（git shortlog / git log --use-mailmap / GitHub Contributors）， 不改写任何提交对象 —— 历史 SHA 全部不变。归并后： git log --use-mailmap → JianFeeeee(715) + HomeAgent Agent(19) HomeAgent Agent **刻意不归并**：agent 的自动提交保留独立身份， 便于区分人类提交与自动化提交。 --- .mailmap | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 .mailmap diff --git a/.mailmap b/.mailmap new file mode 100644 index 0000000..aaf84bc --- /dev/null +++ b/.mailmap @@ -0,0 +1,24 @@ +# .mailmap —— 提交身份归并 +# +# 为什么需要：GitHub 的 Contributors 列表按 **提交邮箱** 归并身份，而本项目历史里 +# 同一个人的提交来自多个邮箱（本地 root、个人 QQ、gitcode noreply、GitHub noreply）， +# 于是列表里出现若干「虚拟贡献者」，看起来像有多个协作者，实际只有一个人。 +# +# 本文件只影响 **展示层**（git shortlog / git log --use-mailmap / GitHub Contributors）， +# 不改写任何提交对象，历史 SHA 全部保持不变。 +# +# 格式：<归并到的姓名> <归并到的邮箱> <历史姓名> <历史邮箱> +# +# 注意：HomeAgent Agent **不归并** —— agent 的自动提交 +# 保留独立身份，便于区分人类提交与自动化提交。 + +JianFeeeee JianFeeeee +JianFeeeee +JianFeeeee <2198972886@qq.com> +JianFeeeee +JianFeeeee +JianFeeeee +JianFeeeee <109188060+JianFeeeee@users.noreply.github.com> + +# 说明：上表用同一主身份覆盖所有历史邮箱；`git shortlog -sne --use-mailmap` 应只剩 +# JianFeeeee 与 HomeAgent Agent 两条。