如何在没有命令行的情况下为 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 -->
[](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 是唯一的安装步骤。