Timestamp GIT

← All posts

2026-11-04

如何在不使用命令行的情况下为 Git 提交添加时间戳

如何在不使用命令行的情况下为 Git 提交添加时间戳
timestamp git blockchain proof

如何在不使用命令行的情况下为 Git 提交添加时间戳

你想要的是那个属性,而不是那套流程。属性是:这个提交哈希在这一天存在,并且这里有一份任何人都能对照比特币区块链验证的凭证。 你想跳过的流程是:在每位开发者的笔记本电脑上安装工具、在聊天记录里翻找证明文件,以及两年后律师问起时,还指望有人记得验证那一端是怎么运作的。

本指南展示如何在不使用命令行工具的情况下为 Git 提交添加时间戳。下面的一切都在浏览器和 GitHub 中完成。你只需安装一次 GitHub App,将它指向一个仓库,然后像今天一样继续提交。Timestamp GIT 每晚对提交哈希进行批处理,通过 OpenTimestamps 协议将它们锚定到比特币中,并将证明凭证推送回你的仓库。

无需 CLI。无需本地比特币节点。无需协议知识。

为什么 Git 时间戳要跳过命令行?

硬核做法确实存在,你大概也能猜到它的样子:在你的机器上安装 OpenTimestamps 客户端,对你构造的一个文件运行命令,把生成的凭证保存在某处,然后在你记得的时候重复一遍。随之而来的是三种失败模式:

  • 它是按机器来的。 让新开发者上手意味着要重新解释这套仪式。你的 CI 运行器也需要它。你更换笔记本电脑后又要再来一遍。
  • 它是按时刻来的。 时间戳只覆盖你记得去打戳的内容。你忘记的那些提交——通常是冲刺期间做出的那些有意思的提交——恰恰是你在纠纷中会需要的。
  • 它是脆弱的证据。 一份放在某人主目录里、没有监管链的凭证,算不上审计追踪。

托管方式把这一切都移到了服务端。Timestamp GIT 是一个 GitHub App,它监视你的仓库,并每晚自动锚定提交哈希。你永远不需要接触底层协议。证明会被写回你自己的仓库,放在一个专用分支或影子仓库中,因此它与它所描述的代码共存。

关于为什么单纯的 git log 本身就不能作为证据的背景,请参阅为什么你的 Git 日志不是证据。本文是操作指南。

前提条件

开始之前,请确认你具备:

  • 一个 GitHub 账户和一个仓库——公开或私有——你想为其添加时间戳。
  • 对该仓库或拥有它的组织拥有管理员权限,以便安装 GitHub App。
  • 对于私有仓库,需要付费计划:Pro Agency($49/月)或 Enterprise ZK($199/月)。公开仓库在 Open Source 计划下免费。
  • 其他什么都不需要。 无需本地软件,无需安装 OpenTimestamps,无需比特币节点,无需钱包。浏览器就是整个工具链。

关于权限有一点说明,因为这是人们最先问的问题。GitHub 的权限模型没有“仅提交哈希”这一范围,因此标准模式需要对源仓库的只读访问权限,以及对写入证明的目标仓库的读写访问权限。如果连对源仓库的只读访问对你来说都不可接受,Enterprise ZK 模式改用 GitHub Action,完全不需要对源仓库的读访问权限。更多内容见第 6 步。

分步指南:无需命令行即可为提交添加时间戳

第 1 步:安装 Timestamp GIT GitHub App

从 GitHub Marketplace 或 timestampgit.dev 安装该应用。安装过程中,系统会询问该应用可以查看哪些仓库,你需要授予上述两组权限:对源仓库的只读权限,对将接收证明文件的仓库的读写权限。

如果你要为整个组织打戳,请在组织级别安装一次,而不是逐个仓库安装。

第 2 步:选择要监视的仓库

打开 https://timestampgit.dev/repos 处的仪表板,选择要监视哪些仓库。仓库连接后,应用会通过 GitHub webhook 检测新提交——无需按提交进行配置,也无需记住任何事。

你可以立即对连接进行基本检查。公开状态端点返回 JSON,无需 CLI:

# Last anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/your-user/your-repo

# How many commits have been stamped so far
curl -s https://timestampgit.dev/api/statusCount/your-user/your-repo

一个全新的仓库在首次夜间运行完成之前返回零计数是正常的。

第 3 步:照常提交

这就是整个“工作流变更”步骤,而它是空的。你写代码,你 git commit,你推送。Timestamp GIT 捕获 webhook 传递的提交哈希——不是差异,不是文件,不是源代码。该服务从不会看到、复制或存储你的实际代码;只有标识仓库状态的 SHA。

实际上,这意味着你的开发者不需要培训,你的安全审查也有一个简短的答案:离开仓库的唯一数据是一个哈希,而哈希是单向指纹。

第 4 步:让夜间 cron 完成锚定

午夜时分,一个工作进程会收集所有待处理的提交哈希,按仓库分组,并为每个仓库写一个清单文本文件。它在该批次上构建 Merkle 树,针对公共 OTS 日历创建 OpenTimestamps 证明,并将 Merkle 根锚定到一笔比特币交易中。

这种设计带来两点:

  • 批处理既便宜又私密。 单独锚定数千个提交会很荒谬。每个仓库每天一个 Merkle 根意味着一个锚点覆盖当天提交的所有内容,而各个哈希则隐藏在树内部。
  • 证明交付不是即时的。 清单和 .ots 凭证文件会在比特币确认之后被推送到专用的时间戳分支或影子仓库,这通常需要大约三个小时。午夜开始的运行通常在清晨完成。

提交哈希会在内存键值存储中等待运行,因此一个安静了一天的仓库只会不产生新的证明文件——而不是错误。

第 5 步:嵌入验证徽章(可选)

打开你仓库的 Repository Connected 页面——https://timestampgit.dev/connected/{user}/{repo}——使用徽章小部件。它会渲染实时预览,并给你一段 Markdown 片段粘贴到 README 中,这样来源声明就是公开且可点击的,而不是一段断言文字。

<!-- Paste the exact snippet generated by the badge widget -->
[![Timestamped with Timestamp GIT](BADGE_URL)](https://timestampgit.dev/status/your-user/your-repo)

点击徽章的人会进入公开状态页面,这也是审计人员会想去的地方。

第 6 步:自托管或采用零知识模式(可选)

对于有更严格要求的团队,存在两种替代部署方式。

Enterprise ZK 模式翻转了数据流:一个 12 行的 GitHub Action 在你自己的基础设施上运行,只将提交哈希推送到 Timestamp GIT API。你的源代码永远不会离开你的环境,也不需要源仓库的读访问权限——只需要对目标仓库的读写权限以交付证明。

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 页面使用你的姓名、公司、电子邮件和可选电话号码申请限时演示许可证,并下载许可证文件进行评估。

如何确认它奏效了

不要把徽章当作证明。按严格程度递增,在三个层面进行确认。

1. 仓库状态页面。 访问 https://timestampgit.dev/status/{user}/{repo}。你会看到证明的持久性、最早的锚定日期、每日规律性、每个锚点背后的比特币区块和交易数据,以及显示哪些日期产生了证明的日历热力图。热力图是发现缺口最快的方式。

2. 审计产物。 从状态页面或 API 拉取审计账本或按日期的证书:

# Full audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/your-user/your-repo

# PDF certificate for a specific date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/your-user/your-repo/2026-11-03

这些是你交给律师或审计人员的文件,而 CSV 是合规团队实际会与内部记录进行比对的东西。

3. 本地密码学验证。 https://timestampgit.dev/verification/{user}/{repo}/{date} 处的验证页面会逐步走完 Merkle 链,所有计算都在你的浏览器中本地进行。你验证的内容不会被传输。同一天的 .ots 凭证文件位于你的时间戳分支中,任何人都可以使用标准 OpenTimestamps 工具独立地对照比特币区块链进行检查——无需账户,无需 API 密钥,也不依赖 Timestamp GIT 是否存在。

最后一点值得向法务重复:证明是 SHA-256 加上比特币区块数据。信任路径中没有专有格式。

排查常见问题

证明还没有出现。 在检查其他任何东西之前,先检查时钟。锚定需要比特币确认,通常在午夜批次之后大约三个小时。如果是凌晨 2 点,没有任何问题。如果到了第二天下午分支仍然是空的,那就看看该仓库是否确实在监视列表中。

清单中缺少提交。 几乎总是权限或 webhook 问题。确认 GitHub App 安装包含该特定仓库(组织安装通常授予“选定仓库”,然后漏掉一个),并且该应用仍有活动连接。在下次夜间运行后重新检查 /api/statusCount/{user}/{repo}。

私有仓库的状态页面无法加载。 私有仓库会在 URL 后附加一个加密的 HMAC,而该 HMAC 特定于服务器实例。请从 Repository Connected 页面复制经过身份验证的徽章链接,而不是手动构造 URL——被截断或实例不匹配的 HMAC 会失败。

Docker 部署无法启动。 验证 Compose 文件准确写明了 rue1401/timestampgit:prod 和 valkey/valkey:8,端口 8080 未被占用,并且 ./data 存在且容器可写。docker compose logs -f timestampgit 通常会直接指出失败的依赖项。如果应用启动了但设置向导无法访问 GitHub,OAuth 配置是应该查看的地方。

常见问题

我需要在开发者机器上安装任何东西吗? 不需要。Timestamp GIT 是一个托管的 GitHub App,运行在 GitHub 的基础设施和我们的服务器上。开发者只需照常提交;不需要 CLI 工具或本地软件。

我可以为私有仓库中的提交添加时间戳吗? 可以。付费计划(Pro Agency 或 Enterprise ZK)支持私有仓库。该应用只读取提交哈希,从不读取你的源代码,证明存储在专用分支或影子仓库中。

时间戳变为不可变需要多长时间? 夜间批次之后,Merkle 根被锚定到一笔比特币交易中。确认通常需要大约 3 小时,之后时间戳就是不可变且可验证的。

证明是否独立于供应商? 是的。证明仅通过 OpenTimestamps 协议使用 SHA-256 和比特币区块数据。你可以使用标准 OpenTimestamps 工具离线验证它,即使 Timestamp GIT 不复存在。

合规团队实际能得到什么? 一个公开状态页面、一个覆盖仓库历史的可下载审计 CSV、每个日期一份 PDF 证书,以及仓库内的 .ots 凭证。关于该证据的法律效力,请参阅区块链时间戳是法律上有效的证据吗?。

结论:安装一次,永久证明

无需命令行为 Git 提交添加时间戳归结为一个决定:不要再把时间戳当作每位开发者的仪式,而是让它成为仓库的一个属性。安装 GitHub App,选择仓库,继续提交。夜间 cron 将这些提交转化为锚定在比特币中的 Merkle 根证明,凭证会落回你自己的仓库中它们该在的地方。

从一个公开仓库上的免费 Open Source 计划开始——它不花任何钱,大约需要五分钟。当你准备好覆盖私有代码时,升级到 $49/月的 Pro Agency,或者如果 GitHub Action 模式更符合你的安全态势,选择 $199/月的 Enterprise ZK。无论哪种方式:timestampgit.dev 是唯一的安装步骤。

相关文章

EU label: AI-generated content