Timestamp GIT

← Tutti gli articoli

2026-11-04

Come aggiungere un timestamp ai commit Git senza la riga di comando

Come aggiungere un timestamp ai commit Git senza la riga di comando
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 传递的提交哈希——不是 diff,不是文件,也不是源代码。该服务从不查看、复制或存储你的实际代码;只处理标识仓库状态的 SHA。

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

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

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

这种设计带来两点:

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

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

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

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

<!-- 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 凭证文件就在你的 timestamps 分支中,任何人都可以用标准 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 和比特币区块数据。即使 Timestamp GIT 不复存在,你也可以用标准 OpenTimestamps 工具离线验证它。

合规团队实际会得到什么? 一个公开状态页面、一份覆盖仓库历史的可下载审计 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