Timestamp GIT

← All posts

2026-10-23

GitHub 提交时间戳在法庭上可被采纳吗?

GitHub 提交时间戳在法庭上可被采纳吗?
timestamp git blockchain proof

GitHub 提交时间戳在法庭上可被采纳吗?

如果你正在搜索 GitHub 提交时间戳是否能作为合法可采纳的证据,那你很可能已经过了理论探讨的阶段。争议已经开启,截止日期临近,有人——客户、合规官,或者你自己的律师——要求你提供证据,证明你的代码在某个特定日期就已存在。

令人不安的答案是:时间戳本身很少是决定性因素。真正决定问题的是,对方和法庭能否在不轻信你一面之词的情况下独立验证该时间戳。

本文涵盖:什么使提交时间戳具有可辩护性、一份法庭就绪的密码学证明实际包含什么,以及如何用 Timestamp GIT 逐步验证。如果你想深入了解为什么普通 Git 日期从一开始就是弱证据,请阅读 Git 提交时间戳用于法律证明可靠吗?。本文专注于验证与可采纳性。

为什么可采纳性取决于验证,而不仅仅是时间戳

标准 Git 提交元数据——作者日期和提交者日期——存在于仓库内部。它可以被回溯、改写,或者在提交被推送之前就被直接伪造。任何有文本编辑器和 rebase 的人都能生成一个声称来自去年的提交。

GitHub 的服务器端时间戳稍好一些,但它们仍然存储在你无法控制的基础设施上、在你无法审计的数据库中,并且无法与该平台之外的任何东西进行核对。它们是一种记录,而不是一种证明。

法庭和审计人员往往在一份技术证据中寻找三个特性:

  • 不可篡改性——记录在事后不能被任何一方更改,包括出示该记录的一方。
  • 独立可验证性——第三方无需访问你的系统或得到你供应商的配合,就能核查该主张。
  • 非自利性——证据不能仅依赖于你自己生成和存储的日志。内部日志经常因这一原因而被视为可操纵。

这就是关键区别:时间戳是一种主张,而密码学证明是一个可验证的事实。主张说“这段代码在 3 月 3 日存在”。证明则让任何人都能自己重新计算答案并得出相同结论。

Timestamp GIT 提供的是后者。它提取你的 Git 提交哈希——你仓库状态的 SHA-1 或 SHA-256 指纹——并通过 OpenTimestamps 协议将其锚定到比特币区块链中。结果不依赖于信任供应商的数据库。

一份法庭就绪的证明实际长什么样

证明链有四个组成部分,在你需要把它们交给律师之前,值得记住它们的名称:

  • 提交哈希——Git 在那一刻生成的精确仓库状态指纹。
  • 每日清单(.txt)——一个文本文件,将某仓库当天收集的所有提交哈希分组。清单本身会得到一个 SHA-256 哈希。
  • Merkle 根——概括跨仓库当天整批数据的单一哈希。
  • .ots 收据文件——一个不可篡改的文件,以密码学方式将你的提交哈希链接到特定的比特币区块。

当人们说“证明”时,通常指的就是 .ots 收据。它使用公共 OpenTimestamps 日历生成,但它所描述的验证路径仅依赖于 SHA-256 和比特币区块数据。这意味着:

  • 它独立于供应商。没有专有格式,没有锁定,十年后即使 Timestamp GIT 不存在,证明仍可核查。
  • 它是零知识的。Timestamp GIT 从不查看、复制或存储你的源代码。只有提交哈希被打上时间戳。
  • 它可以以受众需要的任何格式呈现:给律师或客户的 PDF 证书、给合规部门的 CSV 审计账本,或给技术专家证人的原始 .ots 文件。

分步指南:用 Timestamp GIT 验证时间戳

验证应该是枯燥无味的。以下是实际流程,从“到底有没有东西被锚定?”到“把这份文件交给对方律师”。

1. 查看公共仓库状态页

打开 https://timestampgit.dev/status/{user}/{repo}。此仪表板显示证明的持久性、最早的锚定日期、每日规律性,以及最近锚定背后的比特币区块和交易数据。

# Same data, machine-readable
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api | jq

statusLast 返回最后锚定的比特币区块信息;statusCount 返回已提交和已打时间戳的提交总数。Shields.io 使用的组合摘要可在 statusSummary 获取。

2. 嵌入验证徽章

从仓库连接页面(https://timestampgit.dev/connected/{user}/{repo})你可以获得徽章 URL 和带实时预览的 Markdown 片段。将徽章放入你的 README,这样任何审查该仓库的人——包括未来的审计人员——都能看到验证状态,并点击链接进入验证站点。

返回徽章 URL 和片段的认证端点是:

curl -s https://timestampgit.dev/api/badgeLink/acme/payments-api

3. 追溯特定日期的 Merkle 链

对于带日期的证明,打开 https://timestampgit.dev/verification/{user}/{repo}/{date}。此页面会逐步展示从你的提交哈希到每日根、再到比特币区块的多级 Merkle 链。

所有计算都在浏览器本地进行。没有人——包括 Timestamp GIT——能看到你验证了什么。如果你想在自己的工具中核查,同样的数据也可通过 API 获取:

curl -s https://timestampgit.dev/api/verify/acme/payments-api/2026-10-22 | jq

4. 拉取你实际要归档的记录

# PDF certificate for one day
curl -sO https://timestampgit.dev/api/report/acme/payments-api/2026-10-22

# Full audit ledger as CSV
curl -sO https://timestampgit.dev/api/audit/acme/payments-api

PDF 是给客户或律师的合适产物。CSV 账本是给合规部门、以及用来展示一致且不间断锚定历史的合适产物。

5. 离线独立验证

从你仓库的 timestamps 分支(或影子仓库)下载 .ots 收据文件,并用标准 OpenTimestamps 验证工具对照比特币区块链进行核查。此步骤不需要 Timestamp GIT 账户、不需要 API 访问、也不需要向供应商发起网络调用——这是对“我们怎么知道你的时间戳是真的?”这一问题最强有力的回答。

对于希望将此接入自己仪表板的合规团队,同样的端点可直接调用:

const base = "https://timestampgit.dev/api";
const last = await fetch(`${base}/statusLast/acme/payments-api`).then(r => r.json());
const proof = await fetch(`${base}/verify/acme/payments-api/2026-10-22`).then(r => r.json());

console.log(last.bitcoinBlock, proof.merkleRoot);

私有仓库: 状态 URL 会附加一个特定于服务器实例的加密 HMAC,因此只有授权用户才能查看私有仓库的状态。证明本身仍然锚定在比特币中,你交给任何人的 .ots 文件都能被验证。

解读验证结果与常见边缘情况

验证页面只有在你正确解读它时才有用。有几点需要了解:

  • 已确认 vs. 待确认。 已确认的比特币区块意味着时间戳不可篡改。在确认之前——通常约三小时——证明处于待确认状态。不要把待确认的证明当作最终证明来出示。
  • 尚未锚定。 如果某个提交缺失,它很可能属于下一批夜间批次。每日 cron 工作进程在午夜将所有待处理哈希分组,然后构建清单、Merkle 树和 OpenTimestamps 证明。证明写入本身会在几小时后完成,即比特币确认落地之后。
  • 存在性,而非作者身份。 验证证明你的提交哈希在某个时间点存在。它不证明你编写了代码、代码是原创的,或可申请专利。它是现有技术证据,不是专利。
  • 空白日。 某仓库在某日期没有提交,就没有该日期的证明。状态页的每日规律性视图会让缺口一目了然——这就是为什么一致的锚定历史比单一时间戳更有说服力。
  • 企业 ZK 模式。 有些团队完全不能让服务接触源仓库。在这种设置下,一个小型 GitHub Action 在你自己的基础设施上运行,只将提交哈希推送到 API;服务仅对目标仓库拥有读写权限,从不对源仓库拥有读取权限。验证方式完全相同,因为证明是由哈希构建的。
  • 哈希就是锚。 证明的强度取决于你所声称的哈希。如果你 .ots 文件中的提交哈希与仓库历史中的不一致,验证就会失败——而这种失败正是关键所在。你无法在事后换入一个不同的提交。

Timestamp GIT 如何让验证自动化

这一切的替代方案是你永远跟不上的簿记工作:手动给哈希打时间戳、按仓库跟踪收据,并祈祷没人在你不注意时强制推送。Timestamp GIT 完全消除了这些。

你只需安装一次 GitHub App。从那时起,对受监控仓库的每次提交都会每晚自动锚定到比特币中——无需 CLI 工具、无需手动步骤、无需在开发者机器上安装任何东西。

  • 标准模式(GitHub App)。 该应用只读取仓库的 HEAD 提交哈希。证明被写入专用的 timestamps 分支或单独的影子仓库。GitHub 的权限模型要求至少对源仓库有只读访问权限(不存在仅提交哈希的权限范围),并对目标仓库有读写访问权限。
  • 自托管模式。 对于气隙或最高安全环境,提供 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 页面申请。

  • API 集成。 合规团队可以使用 GET /api/statusLast/{user}/{repo}、GET /api/statusSummary/{user}/{repo}、GET /api/verify/{user}/{repo}/{date}、GET /api/audit/{user}/{repo} 和 GET /api/report/{user}/{repo}/{date} 从自己的仪表板驱动整个流程。

为 DIY 爱好者说句公道话:你可以用原始 OpenTimestamps 命令行工具和手动比特币交易,以艰难的方式拼凑出类似的东西。Timestamp GIT 的存在就是为了让你不必如此——它把协议隐藏在 GitHub App 和夜间 cron 之后。

构建可采纳性就绪的证据链

当证据看起来像一种惯例而非恐慌之举时,它更有说服力。四个习惯能带来这种差别:

  1. 将产物放在一起。 将 .ots 收据、PDF 证书和 CSV 审计账本与你的仓库历史存放在一起——最好放在产品已经写入它们的 timestamps 分支中。
  2. 展示规律性。 公共状态页和 README 徽章表明,在争议开始之前,锚定已经每天进行、持续数月。一致的流程比单一补录的时间戳更难被攻击。
  3. 提前解决锁定问题。 证明可离线验证,且不依赖于 Timestamp GIT 继续存在。在你的证据包中明确说明这一点;它预先化解了“你的供应商这么说”的异议。
  4. 让模式匹配你的风险模型。 如果你的源代码绝不能离开你的环境,企业 ZK 模式会将其保留在那里,同时仍产生相同的比特币锚定收据。

值得重复的一点警告:本文解释的是技术验证路径,不是法律建议。可采纳性规则因司法管辖区和程序类型而异。就你的案件需要什么咨询你的律师——然后交给他们一份无需你在场就能核查的证明。

常见问题

GitHub 提交时间戳本身在法律上可被采纳吗?

标准 GitHub 提交时间戳存储在你无法控制的基础设施上,且可以被更改或回溯,因此它常被视为自利或可操纵的。通过 OpenTimestamps 协议将提交哈希锚定到比特币中的密码学证明可独立验证且防篡改,这使其更有可能被接受为证据。Timestamp GIT 自动提供该证明。

我如何在不信任该公司的情况下验证 Timestamp GIT 证明?

下载 .ots 收据文件,并对照比特币区块链运行标准 OpenTimestamps 验证工具。该证明仅依赖 SHA-256 和比特币区块数据,因此独立于供应商且可离线验证。Timestamp GIT 还提供基于浏览器的验证页面,所有计算都在本地进行。

如果我的仓库是私有的呢?我还能证明时间戳吗?

可以。Timestamp GIT 支持私有仓库。私有仓库的状态 URL 包含加密 HMAC,因此只有授权用户才能查看。证明本身仍然锚定在比特币中,你分享 .ots 文件的任何人都能验证它。

我需要在开发者机器上运行任何命令或安装任何东西吗?

不需要。Timestamp GIT 是一个托管的 GitHub App:你安装一次,对受监控仓库的每次提交都会每晚自动锚定。你的开发者无需 CLI 工具或手动步骤。对于气隙环境,提供 Docker 自托管选项。

结论

关于提交时间戳的可采纳性问题几乎总是归结为一点:对方能否在不信任你的情况下验证它?仓库元数据无法通过这一考验。锚定到比特币中、并以 .ots 收据、PDF 证书和 CSV 账本形式交付的提交哈希则能通过——而且多年后仍能通过,离线,无论供应商是否还在。

Timestamp GIT 为你处理整个流程:安装一次 GitHub App,连接仓库,让夜间锚定自动运行。从 timestampgit.dev 开始,查看你第一个仓库的状态页。

相关文章

EU label: AI-generated content