什么是密码学在先技术?面向软件团队的指南
问一屋子开发者“你们是什么时候构建这个功能的?”,你会得到一个自信的回答。但要求他们以陌生人能够验证的方式证明这一点,整个房间就会安静下来。这个差距——知道某件事与能够向第三方证明它之间的差距——正是密码学在先技术所填补的。
本指南直截了当地回答这个问题:面向软件的密码学在先技术是什么,它如何运作,为什么它对开发者和合规团队都很重要,以及如何在不学习任何协议理论的情况下获得它。
通俗易懂的答案:密码学在先技术究竟意味着什么
密码学在先技术是数学证明,证明某段特定代码在某个特定时间存在——而不需要透露代码本身。
这句话中有三个部分在真正发挥作用:
- 数学证明。 证据可由任何人使用公开数据和标准哈希进行验证。它不依赖于信任日志文件、同事的记忆或供应商的数据库。
- 特定代码。 证明的单位是你工作的指纹,而不是工作本身。指纹是一个哈希——一种单向值,唯一地代表你在某一时刻的仓库状态。你无法将其逆向还原为源代码。
- 不透露代码。 你在保持实现机密的同时获得可证明的存在性和时间。这是专利申请无法给你的属性。
它与其他类型的“在先技术”有何不同
| 证据类型 | 它能证明什么 | 弱点 |
|---|---|---|
| 法律在先技术(专利、出版物) | 存在公开披露 | 昂贵、缓慢,且迫使你公开 |
| 非正式证据(内部日志、邮件、工单) | 你的团队记录了什么 | 可被编辑;常被视为“自利证据”而不予采信 |
| 密码学在先技术 | 某个哈希在固定时间点存在 | 需要有公开锚点才有意义 |
“密码学”部分正是改变主张强度的关键。内部 Git 日志存在于你无法控制的服务器上,或存在于你可以编辑的数据库中。而经过密码学锚定的哈希被冻结在一个公开的、仅可追加的账本中。
它不做什么
密码学在先技术保护的是存在性和作者身份的证明。它不是专有权利的授予,不是专利,本身也不能让你的代码保密——那是你的仓库权限所做的。如果你想要专有权利,你仍然需要申请专利或依赖版权。你在这里得到的是证据:一份带日期、防篡改的记录,可在时间存在争议时出示。
对于软件团队来说,实际的证明单位通常是Git 提交,而不是整个仓库的快照。提交本身已经是细粒度的,已经由 Git 进行哈希,并且已经代表了一个有意义的工作单元。
一个现实世界的类比:公证人、保险箱和收据
想象一下模拟版本:
- 你写了一份文档,把它放进一个防篡改的信封里。
- 你把信封带给一位公共公证人,他记录日期并密封。
- 你保留收据——而且你从不交出文档。
密码学版本几乎一一对应:
- 信封就是哈希。 你提交的 SHA-256 指纹——一个任何人都无法逆向还原为代码的单向值。
- 公证人就是比特币区块链。 一份没有任何单一公司或政府控制的公开记录。
- 收据就是证明文件。 一份你保留的、任何人都可以独立核验的可验证产物。
有两个差异至关重要:
公证人从未看到文档。 只有密封的指纹被记录。你的源代码永远不会离开你的环境。
验证是数学性的,而非机构性的。 对于传统公证人,你信任公证人的持续存在和记录保存。而在这里,验证是针对公开区块数据的算术运算。即使生成证明的公司消失了,你也可以在本地确认一份证明。
把它联系回 Git:每个提交都是一份密封的文档,而每日批次就是去公证人那里——一趟行程为你当天所写的一切盖上时间戳。
它在底层如何运作(不陷入协议兔子洞)
这条链只有三个环节:
- Git 生成提交哈希。 每个提交已经携带一个 SHA-1 或 SHA-256 哈希,代表该时刻的确切仓库状态。
- 哈希被批量汇总为每日清单。 所有待处理的提交哈希按仓库分组为一个纯文本清单(
.txt),然后对该清单进行哈希。 - Merkle 根被锚定进比特币。 许多哈希被合并为一个根,因此单笔比特币交易就能证明跨多个仓库的数千个提交。
Merkle 树这一步正是让这在经济上合理的原因。不必为每个提交支付一笔区块链交易,每天一笔交易就能覆盖整个批次——而每个单独的提交仍然拥有自己可验证的、回溯到根的路径。
是的,你可以用原始的 OpenTimestamps 工具和手工构建的交易自己搭建这套东西。那是困难的方式。托管的方式是一个GitHub App,它每晚自动执行整个流水线。
Timestamp GIT 就是那个托管层。你安装一次 GitHub App,对受监控仓库的每次提交都会被锚定,无需开发者任何操作——没有 CLI 工具,没有协议命令,没有手动步骤。比特币确认通常需要大约三个小时,所以证明文件会在夜间运行几小时后落地。它们以 .ots 收据文件加清单的形式交付,被推送到一个专用的 timestamps 分支或影子仓库中。
为什么它对开发者和合规团队很重要
四类群体从同一机制中获得四种不同的东西:
- 开发者。 保护可复用库、作品集和里程碑日期——而不改变你的工作方式。开发者机器上无需安装任何东西。
- 合规与法务。 获得可用于法庭的、独立于供应商的证据,不依赖可能被编辑或被视为自利证据的内部日志。
- 初创公司和代理机构。 在专利申请之前、在关于交付日期的付款纠纷期间,或当竞争对手声称独立开发了你在 18 个月前发布的功能时,确立在先技术。
- 一般公司。 抵御专利流氓对你内部构建、从未公开的系统索取特许权使用费。
零知识保证正是让安全团队接受这一点的原因:Timestamp GIT 从不查看、复制或存储你的实际源代码。它只对 Git 哈希盖时间戳。验证同样私密——验证页面在你的浏览器中本地运行整个 Merkle 链计算,所以没人能看到你验证了什么。如果你以后想在产品之外检查一份证明,收据文件可与标准 OpenTimestamps 验证工具配合使用,这就是为什么没有供应商锁定。
关于密码学在先技术的常见误解
误解:“这会公开我的代码。” 不会。只有哈希被锚定。哈希是单向指纹——你无法从中重建仓库。源代码留在你的仓库中,受你的访问控制保护。
误解:“它取代专利或版权。” 它不能。它是存在性和时间的证据,而不是专有权利的授予。它是盾,不是剑——但作为抵御宽泛专利主张的盾,它很强大。
误解:“GitHub 提交时间戳就够了。” 服务器端时间戳存在于你不拥有的基础设施上,并且如果仓库被迁移,它们可以被更改、回溯或重建。它们没有被密码学锚定到任何独立的东西上。Git 提交哈希证明什么改变了;只有锚定的时间戳才证明它何时存在。
误解:“它需要区块链专业知识或 CLI 工具。” 使用托管服务则不需要。GitHub App 方式只涉及安装一个应用,仅此而已。开发者完全像今天一样继续提交。
误解:“它只适用于公开仓库。” 私有仓库也受支持。对于私有仓库,状态 URL 会附加一个特定于服务器实例的加密 HMAC,因此只有授权查看者才能看到仓库状态。
Timestamp GIT 如何将这一概念转化为一步式工作流
两种部署模式覆盖了信任光谱的两端。
标准模式(GitHub App)。 安装 GitHub App,它会自动只读取受监控仓库的 HEAD 提交哈希。证明被写入你自己的 timestamps 分支——可以在与源代码相同的仓库中,也可以在一个单独的仓库中。GitHub 的权限模型要求至少对源仓库有只读访问权限(没有仅限提交哈希的权限范围),以及对目标仓库的读写访问权限。
企业 ZK 模式。 一个 12 行的 GitHub Action 在你的基础设施上运行,只将提交哈希推送到 Timestamp GIT API。该服务只需要对目标仓库的读写访问权限,对源仓库则完全不需要——因为哈希来自你自己的运行器。你的源代码永远不会离开你的环境。
从那里开始,流水线是无人值守的:
- 提交哈希被排入内存键值存储中以进行批处理。
- 一个午夜 cron 工作器将待处理的哈希分组,按仓库构建清单文件,原生构建 Merkle 树,并针对公共日历创建 OpenTimestamps 证明。
- Merkle 根被锚定进一个比特币区块。一旦确认,它就是不可变的——没有人能更改或伪造它,包括供应商。
- 清单和
.ots收据被推送回你的仓库。
然后证据层开始发挥作用。可嵌入你 README 的徽章公开显示验证状态。一个按仓库的状态仪表板显示证明的存续时间、最早的锚定日期、每日规律性、比特币区块和交易数据,以及日历热力图。审计 CSV 和 PDF 证书可下载,REST API 可自动化这一切:
# Confirm the last anchored block for a repository
curl -s https://timestampgit.dev/api/statusLast/your-org/your-repo
# Pull the full audit ledger as CSV for a compliance review
curl -s -o audit.csv https://timestampgit.dev/api/audit/your-org/your-repo
# Download the PDF certificate for a specific day
curl -s -o certificate.pdf \
https://timestampgit.dev/api/report/your-org/your-repo/2026-10-12
对于气隙或完全自托管的环境,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 请求表单获得用于评估的限时演示许可证。
常见问题:面向软件团队的密码学在先技术
密码学在先技术在法庭上具有法律可采性吗?
密码学在先技术提供数学上可验证的证据,证明某个特定提交哈希在某个特定时间存在。由于它依赖公开的比特币区块数据和标准 SHA-256 哈希,任何第三方(包括法院指定的专家)都可以独立验证它。它通常与其他证据一起使用,而不是作为法律建议的替代品。
Git 提交哈希和密码学时间戳有什么区别?
Git 提交哈希是你某一时刻仓库状态的指纹,但仅凭它本身并不能证明那个时刻何时发生。密码学时间戳将该哈希锚定进公共区块链,将其存在固定到某个特定的比特币区块。哈希证明什么改变了;时间戳证明它何时存在。
Timestamp GIT 会看到我的源代码吗?
不会。在标准模式下,GitHub App 只读取受监控仓库的 HEAD 提交哈希。在企业 ZK 模式下,你基础设施上的 GitHub Action 只将提交哈希推送到 API,因此该服务从不对你的源仓库有读取访问权限。你的代码永远不会离开你的环境。
开发者需要安装任何东西或改变他们的工作流吗?
不需要。使用托管的 GitHub App,你安装一次,提交就会每晚自动被锚定。没有 CLI 工具,没有 OpenTimestamps 命令,开发者也没有手动步骤。对于气隙或自托管环境,有 Docker 镜像可用。
要点
密码学在先技术是一个狭窄而强大的理念:对你的提交进行哈希,将哈希锚定在公共账本中,保留收据。它不取代你的法律策略——它给你的法律策略提供了法庭真正能够验证的东西。而如今的实际准入门槛大约就是安装一次 GitHub App。
如果你想从下一次提交开始就收集可验证的证明,在 Timestamp GIT 上连接一个仓库——免费的开源层级覆盖公开仓库,Pro Agency($49/月)和 Enterprise ZK($199/月)覆盖私有和气隙设置。