Timestamp GIT

← All posts

2026-10-17

Git 提交时间戳能否作为法律证据可靠使用?

Git 提交时间戳能否作为法律证据可靠使用?
timestamp git blockchain proof

Git 提交时间戳能作为法律证据吗?

如果你是开发者或合规负责人,你很可能问过类似这样的问题:我的提交历史清楚地显示这个功能是我两年前构建的——这难道还不够作为证据吗?

诚实的回答是:这取决于谁控制着时钟。由你的机器写入并存储在你的仓库中的提交时间戳,只是关于过去的一种声明。而锚定在公开、不可篡改账本中的提交哈希,才是关于过去的证据。这两者在 git log 中看起来相似,但在争议中的表现却截然不同。

本文将解释两者的区别,说明为什么在专利主张、员工离职或“我们独立构建了它”这类抗辩出现时这一点至关重要,以及如何在不改变团队编写代码方式的前提下获得锚定时间戳。

简短回答:取决于谁控制着时钟

每个 Git 提交都带有两个时间戳——作者日期和提交者日期——外加一个哈希。这三者都存放在你仓库中的一个文件里。谁能重写那个文件,谁就控制着时间戳。

这单一事实决定了整个法律问题:

  • 自报时间戳——由你的机器生成,推送到你的 GitHub 账户,存储在你或你的托管方可以重写的仓库中。对工程而言可信,作为证据则薄弱,因为出示它的一方同时也控制着它。
  • 外部锚定时间戳——对提交哈希在特定时间点存在的密码学证明,嵌入到公开、不可篡改的账本中。任何人都可以验证,包括你的对手,无需信任你。

对开发者和合规团队来说,实际结论很简短:仅凭 Git 历史是弱证据。Git 历史加上独立的密码学锚定才是强证据。

本文的其余部分将说明这种区别为何存在、锚定究竟是什么,以及如何自动获得它。

为什么普通的 Git 日志是弱证据

先看看一个提交实际包含什么:

git log -1 --format='author:     %ad%ncommitter:  %cd%ncommit:     %H' --date=iso

输出大致如下:

author:     2026-03-14 09:12:44 +0100
committer:  2026-03-14 09:12:44 +0100
commit:     a3f9c1e7b2d4... (abbreviated)

这里没有任何东西受到保护。一次 rebase、一次 amend 或一次 force-push 就能随意重写这些值:

git commit --amend --no-edit --date="2026-01-02T08:00:00"
git push --force-with-lease

由此产生三个结构性问题:

  • “自利记录”问题。 在审计或法庭上,内部日志和截图常常被驳回,因为出示它们的一方同时也是生成和存储它们的一方。一份你可以悄悄编辑的记录不是独立证据。
  • 托管依赖。 标准 Git 历史存放在你不拥有的服务器上——GitHub、GitLab、内部 VPS——或者存放在你可以写入的数据库中。来源无法由第三方独立验证。
  • 没有外部见证。 即使是一条诚实的时间线,也没有任何你基础设施之外的东西来确认该提交在那个日期存在。

后果是具体的。专利流氓对你几个月前就已发布的技术提出宽泛主张,而没有带日期的证明,你将面临本可以早早了结的诉讼。当一位主力开发者离职时,“那个功能是我构思的”就变成了一场各执一词的争吵。竞争对手声称对同一功能进行了“洁净室”独立构建,而你没有任何东西能证明你在 18 个月前就已经有了完成的逻辑。

一个现实类比:为密封信封做公证

想想公证人。你递交一个密封的信封。公证人不会打开它、阅读它或保留副本。他们只证明一个狭窄的事实:这个信封,处于这个确切状态,在这一刻存在——而且他们的记录日后可由第三方核查。

密码学 Git 时间戳几乎完全对应这一模型:

公证类比 Git 现实
密封信封 提交哈希——你确切仓库状态的指纹
公证印章和登记簿 记录该哈希存在的公开、不可篡改账本
“我不需要读它” 零知识:只处理哈希,绝不处理你的源代码
任何人都能验证印章 无需信任你或服务方即可独立验证

关键属性是独立性。一个为你工作、自己保存记录、并能应要求重新签发印章的公证人在法庭上毫无价值。这里同样如此:见证者必须是公开且不可篡改的,而且即使见证者的运营方消失了,验证也必须仍然有效。

密码学 Git 时间戳实际如何工作

该机制有三个步骤。它们都不要求你把源代码读入第三方系统。

第 1 步——指纹

Git 已经生成了一个单向 SHA-1 或 SHA-256 哈希,代表你整个仓库在该提交时的确切状态。改动一个字节,哈希就完全改变。这是你那一刻工作的密码学安全指纹——无需提取任何更多东西。

第 2 步——锚定

提交哈希按仓库被收集到一个每日清单文本文件中,哈希成一棵 Merkle 树,Merkle 根通过 OpenTimestamps 协议嵌入到一笔比特币交易中。这就把哈希的存在冻结在时间中,不可篡改地记录在某个特定的比特币区块里。

在托管流水线中,这是按计划运行的:提交哈希在白天进入队列,一个午夜工作进程将它们批量处理,构建 Merkle 树和证明,并锚定根。比特币中的确认通常需要大约三小时,因此证明会在批量运行后几小时出现。

第 3 步——证明

你会收到一个不可篡改的 .ots 收据文件,与清单放在一起。该收据让你能够向律师、审计师或法庭证明——你的想法在某个特定日期存在。证明完全依赖 SHA-256 和比特币区块数据,因此可以离线且独立地验证。

这一设计带来三项保证:

  • 零知识——你的源代码从未被看到、复制或存储。只有 Git 哈希被盖章。
  • 厂商无关——没有专有格式,没有锁定。验证依赖公开密码学和比特币区块数据。
  • 符合法庭标准——全球公认的密码学原语,而非厂商的私有日志。

为什么这对知识产权争议很重要(以及常见误解)

锚定时间戳改变了三类常见争议的形态:

  • 专利主张。 一份密码学带日期的记录,证明你在某个申请之前就实现了某事物,这是可以无效化宽泛主张的现有技术。
  • 员工构思争议。 “这个功能是什么时候构思的?”不再是记忆力的较量,而变成一条可核查的时间线。
  • “独立开发”抗辩。 证明你在 18 个月前就已经有了完成的逻辑,是一堵洁净室说辞无法翻越的墙。

有三个误解反复出现。

误解 1:“我的 GitHub 提交历史就够了。” 托管历史是可编辑的,且由与结果有利害关系的一方控制。它是有用的背景信息。它不是独立证据。

误解 2:“我需要学习 OpenTimestamps 和比特币交易。” 艰难的路确实存在——手动组装证明并广播交易是可行的。对大多数团队来说,这是不必要的开销,而且恰恰是在截止日期压力下会被跳过的那类事情。(关于这些证明在法律上代表什么的背景,参见什么是密码学现有技术?软件团队指南。)

误解 3:“时间戳服务能看到我的代码。” 只处理提交哈希。零知识模型意味着源代码从不离开你的控制——而且在下面描述的企业模式中,服务甚至根本不需要对源仓库的读取权限。

实用路径:使用 Timestamp GIT 实现自动化、零配置的时间戳

Timestamp GIT 是一个托管 SaaS 加 GitHub App,完全自动化并隐藏了 OpenTimestamps 协议。你安装一次 GitHub App。此后,对受监控仓库的每次提交都会每晚自动锚定到比特币中——无需 CLI 工具,无需协议命令,无需手动步骤,也无需在开发者机器上安装任何东西。

有两种部署模式:

  • 标准模式(GitHub App)。 该应用只读取受监控仓库的 HEAD 提交哈希,然后将证明写入一个专用的 timestamps 分支——可以在与源相同的仓库中,也可以在一个单独的影子仓库中。GitHub 的权限模型意味着该应用至少需要对源仓库的只读访问权限(不存在仅限提交哈希的权限),以及对目标仓库的读写访问权限。
  • 企业零知识模式。 一个 12 行的 GitHub Action 在你自己的基础设施内运行,只将提交哈希推送到 Timestamp GIT API。你的源代码从不离开你的环境,服务完全不需要对源仓库的读取权限——只需要对目标仓库的读写访问权限以交付证明。

你得到的东西是为合规工作而构建的,而不仅仅是为工程:

  • 验证徽章,你可以嵌入到 README 中,并附上一个任何人都能查看的公开链接。徽章小部件带有实时预览,让你在提交之前就能看到 Shields.io 徽章。
  • 每个仓库的公开状态仪表板——证明寿命、最早锚定日期、每日规律性、比特币区块和交易数据、日历热力图,以及可下载的审计 CSV 和 PDF 证书。
  • 用于自动化的 REST API:GET /api/statusSummary/{user}/{repo} 获取徽章数据,GET /api/audit/{user}/{repo} 获取完整审计账本 CSV,GET /api/report/{user}/{repo}/{date} 获取按日期的 PDF 证书,GET /api/verify/{user}/{repo}/{date} 获取用于本地验证的完整 Merkle 链数据。
curl -s https://timestampgit.dev/api/statusSummary/your-user/your-repo

私有仓库会在 URL 后附加一个加密的 HMAC,因此只有授权用户才能读取私有仓库的状态——该 HMAC 特定于服务器实例。

对于气隙或最高安全环境,Timestamp GIT 还提供 Docker 自托管镜像。一个快速开始的 Docker Compose 配置如下:

services:
  timestampgit:
    image: rue1401/timestampgit:prod
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    restart: unless-stopped
  valkey:
    image: valkey/valkey:8
    restart: unless-stopped
docker compose pull
docker compose up -d
docker compose logs -f timestampgit

启动后,应用程序可在 http://localhost:8080 访问,首次启动的设置向导会引导你连接 GitHub App 并配置实例。可以从 Docker License 页面申请一个用于评估的限时演示许可证;你提交姓名、公司、电子邮件和可选的电话号码,然后下载演示许可证文件。

将其与手动路线相比——自己接入协议、处理批处理、Merkle 树、证明交付和验证工具——托管工作流就是一步安装与一个持续工程项目之间的区别。

常见问题

我可以直接把我 GitHub 的提交历史作为法律争议中的证据吗?

GitHub 历史是有用的背景信息,但通常被视为自报且可编辑的,因此在审计或法庭上常被作为自利证据驳回。密码学锚定增加了一个独立的、不可篡改的时间戳,任何人都可以对照公开账本进行验证,这正是它成为符合法庭标准证据的原因。

Timestamp GIT 会看到或存储我的源代码吗?

不会。该服务采用零知识模型运行:它处理提交哈希,绝不处理你的实际源代码。在标准模式下,GitHub App 只读取 HEAD 提交哈希。在企业零知识模式下,一个在你自己的环境中运行的 12 行 GitHub Action 只推送哈希,这意味着该服务不需要对源仓库的读取权限。

如果 Timestamp GIT 关闭了怎么办?我还能证明我的时间戳吗?

能。证明仅依赖 SHA-256 和通过 OpenTimestamps 协议的比特币区块数据,因此与厂商无关。你可以下载你的 .ots 收据文件,并使用标准验证工具对照比特币区块链在本地验证它们,即使公司消失了也可以。有关操作指南,参见如何在本地验证比特币时间戳证明。

我需要在我的开发者机器上安装任何东西或学习 OpenTimestamps 吗?

不需要。Timestamp GIT 是一个托管的 GitHub App:你安装一次,对受监控仓库的每次提交都会每晚自动锚定到比特币中。你的开发者无需 CLI 工具、无需协议命令、无需手动步骤。对于气隙环境,可以使用 Docker 自托管选项。

底线

Git 提交时间戳的可靠性只取决于其背后的时钟。如果那个时钟是你自己的服务器或你的托管账户,那就等着对手称其为自利证据吧。如果那个时钟是一个公开、不可篡改、任何人都能在不信任你的情况下验证的账本,那么时间戳就变成了证据。

Git 历史加上密码学锚定才是经得起考验的组合。唯一剩下的问题是,你愿意花多少精力来维护它。

安装一次 GitHub App,连接一个仓库,让每晚的锚定处理其余的事——然后第二天早上查看你的徽章、你的状态仪表板和你的第一份 .ots 收据。

相关文章

EU label: AI-generated content