Timestamp GIT

← All posts

2026-10-24

比特币时间戳能为你的代码证明什么?

比特币时间戳能为你的代码证明什么?
timestamp git blockchain proof

比特币时间戳能为你的代码证明什么?

如果你曾目睹过一场付款纠纷、一次专利威胁,或一位即将离职的联合创始人演变成"证明它确实发生在你所说的那个时间"的争论,那么你已经撞上了同一个问题:你的 Git 历史存放在你并不拥有的服务器上,存放在可以被编辑的数据库中。所以,当有人问比特币时间戳究竟能为你的代码证明什么时,诚实的答案比你在别处看到的营销炒作要狭窄得多——而一旦你理解了它的边界,它反而更有用。

本文直截了当地回答这个问题,然后展示 Timestamp GIT 如何把这个答案变成每次提交时自动发生的事。

通俗易懂的答案:比特币时间戳究竟证明了什么

比特币时间戳只证明一件事:某份特定的数据在某个时间点或之前已经存在。

仅此而已。不多也不少。

在源代码的语境下,"某份特定的数据"就是你的 Git 提交哈希——Git 为某个仓库状态生成的 SHA-1 或 SHA-256 摘要。当这个哈希被锚定进一个比特币区块时,你就获得了一个可被数学验证的陈述,形式如下:

这个确切的哈希不晚于区块 N 存在,而区块 N 是在日期 D 被挖出的。

这个陈述没有声称的内容:

  • 它不证明你创作了这段代码。
  • 它不证明这段代码是好的、原创的、新颖的,或不侵权的。
  • 它本身不证明你在法律意义上拥有任何东西。
  • 它不透露任何关于代码内容的信息。

它真正做到的,是消除了一整类争论。一旦某个哈希进入比特币区块,任何人——你、竞争对手、托管服务商、乃至 Timestamp GIT 本身——都无法把它回溯日期或篡改它。这就是你所购买的属性。

而让它变得实用的关键在于:当你把锚定的哈希与你的 Git 历史结合起来时,你就得到了一条可验证的链条,从你实际的提交一直延伸到一本公开、不可篡改的账本。哈希并非漂浮在虚空中——它绑定到一个提交,提交绑定到一个仓库,仓库绑定到你的组织。

Timestamp GIT 通过一个 GitHub App,为每一次提交自动完成这条链条,因此你永远不必接触底层的密码学。

一个现实世界的类比:你代码的公证人

想想公证人是如何工作的。你把一份文件封进信封,交出去,公证人在外面盖上一个日期戳。公证人不会阅读内容。他们只证明这个密封物件在这一天存在过。

比特币时间戳就是同一套安排在全球化规模下的版本:

  • 密封的信封是你的提交哈希。它是指纹,不是副本。你无法把 SHA-256 摘要逆向还原成你的源文件,这正是该证明在构造上就是零知识的原因。
  • 公证人是比特币网络。它全球分布式存在,没有你可以打电话的办公室,也没有人能贿赂它签发一个日期为昨天的戳。
  • 收据是你的 .ots 文件,你可以把它交给律师、审计师或对方律师。

现在想象一位公证人每晚都来你的办公室,在你睡觉时给每一个新提交盖章,并把收据归档到你自己的仓库里。这就是原始协议——你得自己组装信封、自己去找公证人——与 Timestamp GIT 之间的区别,后者就是那位自动化的公证人。

底层原理:你的提交哈希如何变成比特币证明

这条流水线有三个阶段。你不需要手动操作其中任何一个,但了解发生了什么值得一做。

1. 指纹。 每次你提交时,Git 都会生成一个单向哈希,代表那一刻你仓库的确切状态。这由 Git 在本地生成;无论你是否曾经为任何东西打时间戳,它都存在。

2. 锚定。 Timestamp GIT 只提取提交哈希——从不提取文件,从不提取差异,从不提取分支内容。这些哈希按仓库被收集成每日文本清单,从中构建一棵默克尔树,默克尔根则通过 OpenTimestamps 协议和公共 OTS 日历被锚定进一个比特币区块。

3. 证明。 一个不可篡改的 .ots 收据文件被写回你的仓库——放在一个专用的 timestamps 分支或影子仓库中。这份收据让任何人都能对照比特币区块数据验证该哈希。

这里的关键细节:只有哈希被锚定。 在 Enterprise ZK 模式下,流水线中没有任何一个环节会传输、存储或读取你的源代码。该证明可以离线验证,只使用 SHA-256 和比特币区块数据,这意味着即使 Timestamp GIT 明天消失,它依然有效。

两条值得内化的操作说明:

  • 比特币确认通常需要大约三小时,所以证明会在夜间批处理运行几小时后落入你的仓库,而非即时到达。
  • GitHub App 通过 webhook 自动处理提交检测。在 Enterprise ZK 模式下,一段运行在你自己基础设施上的 12 行 GitHub Action 只把提交哈希推送到 API——你的源代码永远不会离开你的环境。

为什么这对开发者和合规团队很重要

这两类受众关心的是同一个保证的不同两半。

对开发者而言,比特币锚定的历史是有牙齿的现有技术:

  • 专利流氓。 如果一个非实施实体对你几个月前就已实现的东西申请了一项宽泛专利,锚定的哈希就是使该主张无效的盾牌。没有它,你就只能靠记忆和内部日志来打官司。
  • 员工纠纷。 当一位首席开发者离职,问题变成"这个功能究竟是什么时候被构思出来的?",一个不可篡改的时间戳就能取代各执一词的僵局。
  • 净室开发主张。 一个声称独立开发的竞争对手,很难解释为什么你已完成的逻辑在他们发布前 18 个月就被密码学锚定了。

对合规团队而言,价值在于证据层面:

  • 内部 Git 日志通常会被视为自利证据而不被采信,因为组织控制着数据库。比特币锚定的证明是公开且不可篡改的,对照中立基础设施进行验证。
  • 该证明独立于供应商。它依赖 SHA-256 和比特币区块数据,而非只有一家公司能验证的专有格式。
  • 报告产物开箱即用:可下载的审计 CSV、按日期生成的 PDF 证书、可嵌入的验证徽章,以及一个公开状态仪表盘,展示证明的存续时长、最早锚定日期、每日规律性,以及所涉及的比特币区块和交易。

私有仓库还多一层保障:公开状态 URL 会附加一个特定于服务器实例的加密 HMAC,因此只有授权用户才能看到这些仓库的状态。

关于比特币时间戳的常见误解

“它证明代码是我写的。” 它证明代码在某个时间点存在过。作者身份是另一回事。在实践中,比特币锚定的哈希加上你的 Git 提交历史——提交作者、仓库、时间线——是作者身份的有力佐证,但时间戳本身关乎存在,而非身份。

“它会暴露我的源代码。” 不会。只有哈希被锚定。SHA-256 摘要无法被逆向还原成原始文件。在 Enterprise ZK 模式下,服务对源仓库根本没有读取权限——一个 GitHub Action 只推送哈希。

“我需要运行复杂的 CLI 工具。” 用托管方案就不需要。你安装一次 GitHub App,之后每晚流水线都会替你运行。没有命令要输入,开发者的机器上也没有任何东西要安装。

“它又贵又慢。” 锚定是夜间批处理操作,已包含在托管服务中。确认需要几个小时,因为比特币就是这样确认区块的——但它在无人值守的情况下发生,落地时你会得到一份 .ots 收据。

“它不过是多了几步的服务器日志。” 服务器日志存在于你控制且可以编辑的数据库中。比特币锚定存在于没有任何单一主体控制的账本中。这一区别就是全部意义所在,也是证据与主张之间的差别。

Timestamp GIT 如何让它毫不费力

这套工作流刻意做得枯燥乏味,而这正是你希望从一条证据流水线中得到的东西。

  1. 安装一次 GitHub App。 对受监控仓库的每一次提交都会被自动检测。无需 CLI 工具,无需逐次提交操作,无需协议知识。
  2. 选择你的部署模式。 Standard 模式只读取受监控仓库的 HEAD 提交哈希,并把证明写入一个单独的分支或影子仓库。它需要对源仓库至少只读权限(GitHub 的权限模型中没有仅提交哈希的权限),以及对目标仓库的读写权限。Enterprise ZK 模式完全不需要对源仓库的读取权限,也不涉及源代码移动——只需要那个 GitHub Action。
  3. 消费结果。 用于 README 的验证徽章、一个公开状态仪表盘,以及供你自己工具使用的 REST API:
# Last anchored Bitcoin block for a repo
curl https://timestampgit.dev/api/statusLast/acme/payments-service

# Combined summary, suitable for Shields.io
curl https://timestampgit.dev/api/statusSummary/acme/payments-service

# Full Merkle chain data for local verification of a specific day
curl https://timestampgit.dev/api/verify/acme/payments-service/2026-10-24
  1. 需要时自托管。 对于气隙环境,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 页面提交申请表单即可获得限时演示许可证。

常见问题

比特币时间戳能证明代码是我写的吗?

不能——它证明代码在特定时间存在过。然而,结合你的 Git 提交历史以及哈希绑定到你仓库这一事实,它提供了作者身份的有力证据。Timestamp GIT 锚定你的提交哈希,创建了一条从你的工作到比特币区块链的可验证链条。

我能在不信任 Timestamp GIT 的情况下验证比特币时间戳吗?

可以。.ots 收据文件可以使用标准 OpenTimestamps 工具对照比特币区块链独立验证。该证明只依赖 SHA-256 和比特币区块数据,因此即使 Timestamp GIT 消失,你也可以离线验证它。

Git 提交时间戳和比特币时间戳有什么区别?

Git 提交时间戳由你的本地机器设置,很容易被操纵。比特币时间戳锚定在公开、不可篡改的区块链中,任何人都无法更改或回溯日期,包括 Timestamp GIT。

我需要运行任何命令来为提交打时间戳吗?

不需要。使用 Timestamp GIT,你安装一次 GitHub App,它就会每晚自动为受监控仓库的每一次提交进行锚定。无需 CLI 工具或手动步骤。

结语

比特币时间戳证明的是在时间中的存在——仅此而已,而正是这一局限让它值得信赖。它不依赖任何人的诚实,不依赖某家供应商能否继续经营,也不依赖一份没人能审计的日志文件。结合你的 Git 历史,它为你提供了一条从你的工作到一本无人能改写的公开账本的可验证链条。

剩下的唯一问题是:你想手动维护这条链条,还是让它每晚在你不假思索的情况下自动发生。安装 GitHub App,连接一个仓库,让锚定运行起来——然后查看你的状态仪表盘,在 README 里放上一个徽章。从你开始的那天起,你做出的每一次提交都将拥有存在证明。

准备好锚定你的第一次提交了吗?开始使用 Timestamp GIT。


相关文章

EU label: AI-generated content