如何在竞争对手之前证明你已交付某项功能
竞争对手的发布博文在周二上午上线。截图、定价页面、演示视频——而那个功能是你的。你在十四个月前就把它做出来了。你有提交历史可以证明这一点,它就躺在一个私有的 GitHub 仓库里。
你缺的是让任何人相信那段提交历史不是上周才被编辑过的方法。
这个缺口——介于拥有证据与能够证明它之间——正是本文要讨论的内容。不是泛泛而谈,而是针对受此影响最深的那群人:创始人、代理机构、自由职业者,以及事后不得不为他们辩护的合规团队。
需要证据的创始人:一个真实场景
设想一位种子轮创始人,我们叫她 Mara。她的团队花了一年时间为某个细分垂直领域构建工作流自动化层。随后,一家资金更充裕的竞争对手发布了一款核心概念相同的产品,借此完成了 A 轮融资,还有记者来问 Mara 有何评论。
她在这场对话中的立场完全取决于一个问题:你能证明这是你先做的吗?
Mara 有 Git 历史。她还有:
- 一个位于 GitHub 上的仓库,其所属组织的设置任何管理员都能更改。
- 提交日期——在 Git 中,这些只是由提交者提供的元数据。强制推送、变基或重写历史,日期就会随之改变。
- 截图、Slack 讨论串和一份 Notion 文档——在法律环境中,这些没有一样经得起认真的质疑。
换句话说,她有的是一个故事,而不是证据。与投资人的对话陷入停滞。叙事从“我们是第一个做的”变成了“我们觉得他们抄了我们,但我们证明不了”。这是一个会累积成估值问题的可信度问题。
令人不安的真相:内部日志的可信度,只取决于控制其所在服务器的那个人。在纠纷中,那个人就是你——这使它对另一方毫无价值。
密码学时间戳解决的正是这个具体问题。它不是让你的日志更漂亮,而是把你代码的指纹锚定到一个公开、不可篡改的账本中,任何人——包括为其打时间戳的服务商——都无法重写。本文余下部分,是为处于 Mara 这种境地的团队准备的实操版本。
为什么开发者和合规团队需要密码学证明
被问到“你能证明吗?”的人,很少是工程师。他们是在尽职调查电话中的创始人、在付款纠纷中的代理机构老板,或是在准备知识产权审计的合规负责人。以下是他们各自会遇到的情况。
内部 Git 日志在设计上就是可编辑的。 Git 是一个分布式系统,其设计初衷就是历史可以被重写。这对开发是特性,对证据则是隐患。当对方律师主张你仓库的时间戳是自说自话时,他们并非在胡乱指控——他们提出的是显而易见的那一点。
“我们是独立开发的”是默认抗辩。 竞争对手不需要抄袭你就能伤害你。他们只需要说自己没有抄,而在没有可验证的现有技术的情况下,这一断言和你的否认一样有效。
合规团队需要防篡改的工件。 审计师或法庭想要的是无需信任你的基础设施、你的员工或你的服务商就能核查的东西。这意味着一种可归约为公开数学的证明——一个哈希和一个区块高度——而不是数据库里的一行记录。
专利风险是不对称的。 非实施主体可以针对成千上万个团队已在生产环境中运行的技术提出宽泛的权利主张。如果你无法证明你构建它的日期,为自己辩护的成本就完全落在你身上。
如果你想了解为什么一个哈希能证明存在性、以及现有技术如何使权利要求无效的概念基础,概念页面和问题陈述有深入阐述。就本文而言,机制不如工作流重要:某种自动的、持续的、可独立验证的东西。
而这正是托管式时间戳服务所填补的缺口。
你的行动手册:用 Timestamp GIT 证明现有技术
以下是完整清单,按顺序排列。注意其中涉及的工程投入少得可怜——这是有意为之。
第 1 步:在你的仓库上安装 GitHub App
从 GitHub Marketplace 安装 Timestamp GIT,并选择要监控的仓库。无需向代码库添加任何东西,没有依赖,不用编写 CI 配置,也不用在开发者机器上安装任何东西。你的团队照常提交即可。
权限方面,以免有意外:
- 标准模式需要对源仓库的只读访问权限——GitHub 的权限模型不提供“仅提交哈希”的权限范围——以及对存放证明的目标仓库的写权限。
- 证明工件会写入一个专用的 timestamps 分支,可以位于同一仓库,也可以位于单独的影子仓库。
第 2 步:让夜间锚定自动进行
连接之后,流水线无需你干预即可运行:
- GitHub App 通过 webhook 检测新的提交。
- 提交哈希被排入内存键值存储以进行批处理。
- 午夜 cron worker 将所有待处理的哈希分组,为每个仓库写入一个清单
.txt,构建 Merkle 树,针对公共 OTS 日历生成 OpenTimestamps 证明,并将 Merkle 根锚定到比特币区块链。 - 清单和
.ots收据文件被推送回你的 timestamps 分支。
比特币确认通常需要约三小时,因此某一晚的证明会在该批次锚定几小时后出现。你无需监控这一过程。
第 3 步:收集你的收据和验证徽章
每一个完成锚定的日期都会给你一个不可篡改的 .ots 收据文件,以及一个可嵌入 README 的徽章。徽章链接指向一个公开验证视图,因此任何评估你主张的人——投资人、律师、客户——都无需账户即可核查。
公共仓库由免费的 Open Source 套餐覆盖;私有仓库则使用 Pro Agency 套餐。你也可以通过程序获取徽章 URL 和 markdown 片段:
curl -s https://timestampgit.dev/api/badgeLink/your-org/your-repo
第 4 步:为利益相关方生成证据
当真的有人要求提供证明时,不要拼凑一个装满截图的 zip 文件。使用为此目的构建的工件:
- 仓库状态页面——证明存续时长、最早锚定日期、每日规律性、比特币区块和交易数据、日历热力图,以及可下载的审计 CSV 和 PDF 证书。
- 密码学验证页面——按日期逐步展示 Merkle 链,完全在浏览器中计算。没有人能看到你验证了什么。
- PDF 证书——一份按日期生成的文档,可附到法律或采购讨论串中。
# Full audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/your-org/your-repo
# PDF certificate for a specific anchored date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/your-org/your-repo/2026-11-03
私有仓库会在其状态 URL 后附加加密的 HMAC,因此只有获得授权的查看者才能查询。
对于无法授予读取权限的团队:Enterprise ZK 模式
有些组织——受监管行业,或任何源仓库访问本身就要接受审计的组织——无法将读取权限交给第三方。在该模式下,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 许可证页面获取限时演示许可证。
证明现有技术时应避免什么
这里的失败模式既无聊又昂贵。以下五点都要避免。
- 不要依赖内部日志、Slack 截图或文档修订历史。 它们中的每一个都能被你这边的人编辑,而这恰恰是你将面临的反对意见。
- 不要试图手工实现协议。 手动组装哈希、提交到日历服务器并管理证明文件是困难的做法——容易出错、容易做错,而且不是你想在宣誓证词中解释的东西。
- 不要等到纠纷开始才行动。 现有技术只有早于相关主张才有用。时间戳从你安装 GitHub App 那天开始,并逐日积累价值;追溯性打时间戳在构造上就是不可能的。
- 不要把公共仓库与证明混为一谈。 让代码可见告诉人们你构建了什么,而不是你何时构建的。可见性和可验证的存在性是两种不同的属性。
- 不要依赖单一服务商的单一不间断信任链。 问问证明能否在没有服务商的情况下验证——对 Timestamp GIT 而言,答案是肯定的,这正是接下来要讲的一点。
Timestamp GIT 如何融入你的合规工作流
合规审查者会就任何证据流水线问三个问题:什么数据离开了环境、存在什么文档,以及如果服务商消失了会怎样。以下是它如何回答这些问题。
架构上的零知识。 Timestamp GIT 从不查看、复制或存储你的源代码。它提取提交哈希,将其分批,并锚定一个由 SHA-256 派生的 Merkle 根。你的实际逻辑留在你的仓库中。
按需提供文档。 审计账本可下载为 CSV,并会为你需要引用的日期生成按日期的 PDF 证书。状态端点以 JSON 暴露锚定数据,以便你将其输入内部风险登记册:
curl -s https://timestampgit.dev/api/statusLast/your-org/your-repo
curl -s https://timestampgit.dev/api/statusCount/your-org/your-repo
curl -s https://timestampgit.dev/api/statusSummary/your-org/your-repo
服务商独立性。 证明可归约为 SHA-256 和比特币区块数据——没有专有格式,没有锁定。即使 Timestamp GIT 不复存在,收据仍可离线对照比特币区块链进行验证。
可公开发布的透明度。 可嵌入的徽章把验证链接直接放进你的 README,因此任何访问该仓库的人都能核查这一主张,而不是只在私人演示文稿中断言。
对于比较各种方法的团队,专利 vs 时间戳:保护源代码知识产权最便宜的方式探讨了何时专利是合适的工具、何时密码学证明是。它们解决不同的问题,而大多数团队首先需要的是更便宜的那个。
常见问题
比特币时间戳在法庭上具有法律可采性吗? 锚定在比特币区块链中的密码学时间戳正日益被认可为防篡改证据。Timestamp GIT 提供可独立验证的、可供法庭使用的证明,使其适用于关于现有技术的法律纠纷。
使用 Timestamp GIT 需要改变我的开发工作流吗? 不需要。安装 GitHub App 后,Timestamp GIT 每晚自动为你监控的仓库中的每次提交打时间戳。无需 CLI 工具或手动步骤。
如果我的仓库是私有的,我能证明某个功能存在过吗? 当然可以。Timestamp GIT 只处理提交哈希,从不处理你的源代码。私有仓库受支持,证明存储在单独的分支或影子仓库中,不会暴露你的代码。
如果 Timestamp GIT 倒闭了怎么办? 你的证明锚定在比特币区块链中,与服务商无关。你可以使用标准的 OpenTimestamps 验证工具离线验证它们,即使我们的服务停止,也能确保长期有效性。
这能替代申请专利吗? 不能。时间戳证明你在某一天拥有该代码;它不授予排他性。它做的是确立现有技术,从而可以使别人的宽泛主张无效——而且成本只是申请费用的一小部分。
在你构建它的那天就证明它,而不是在被问起的那天
Mara 的问题不是她缺乏证据。而是她的证据需要别人信任她。密码学锚定消除了这一要求:一个提交哈希、一个 Merkle 根、一个比特币区块,以及一份任何人都能核查的收据。
设置成本是一次 GitHub App 安装。持续成本是零开发者投入,因为无论有没有人记得它的存在,夜间锚定都会运行。
如果你正在交付任何你愿意为之辩护的东西——一个功能、一个库、一整个产品——现在就启动计时。安装 GitHub App到一个仓库,明天确认你的第一次锚定,然后把徽章放进你的 README。两天后,你将拥有竞争对手无法追溯抹去的东西。
相关文章
- 专利 vs 时间戳:保护源代码知识产权最便宜的方式
- 代码时间戳的 Timestamp GIT 替代方案:对比
- 用 GitHub App 自动化 Git 提交时间戳