什么是密码学在先技术?软件团队指南
问一屋子开发者"你是什么时候构建这个功能的?",你会得到一个自信的回答。让他们以一种陌生人可以验证的方式来证明它,整个房间就会安静下来。这个差距——介于知道某件事和能够向第三方证明它之间——正是密码学在先技术所填补的。
本指南直截了当地回答这个问题:什么是软件的密码学在先技术,它如何运作,为什么它对开发者和合规团队都很重要,以及如何在不学习一丁点协议理论的情况下获得它。
通俗易懂的答案:密码学在先技术究竟意味着什么
密码学在先技术是数学证明,证明某段特定代码在某个特定时间存在——而不揭示代码本身。
这句话中有三个部分在发挥实际作用:
- 数学证明。 任何人都可以使用公开数据和标准哈希来验证这些证据。它不依赖于信任日志文件、同事的记忆或供应商的数据库。
- 特定代码段。 证明的单位是你工作的指纹,而不是工作本身。指纹是一个哈希——一个单向值,唯一地代表你在某一时刻的仓库状态。你无法将它逆向还原为源代码。
- 不揭示代码。 你在保持实现机密的同时获得可证明的存在性和时间。这是专利申请无法给你的属性。
它与其他类型"在先技术"的区别
| 证据类型 | 它证明什么 | 弱点 |
|---|---|---|
| 法律在先技术(专利、出版物) | 存在公开披露 | 昂贵、缓慢,且迫使你公开 |
| 非正式证据(内部日志、邮件、工单) | 你的团队记录了什么 | 可编辑;常被视为"自利证据"而不被采信 |
| 密码学在先技术 | 某个哈希在固定时间点存在 | 需要公共锚定才有意义 |
"密码学"部分改变了主张的强度。内部 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/月)和企业 ZK($199/月)覆盖私有和气隙设置。