Timestamp GIT

← Tutti gli articoli

2026-10-14

Come i freelance possono dimostrare la proprietà del codice prima di una controversia

Come i freelance possono dimostrare la proprietà del codice prima di una controversia
timestamp git blockchain proof

自由职业者如何在纠纷发生前证明代码所有权

Mira 在三月向一位客户交付了一个 billing-utils 库。里程碑已批准,发票已付款,Figma 文件已归档。生活继续向前。

八个月后,她在浏览某个竞争对手的更新日志时看到了它:同样的带抖动重试退避,同样的针对部分退款的奇怪边界情况处理,同样的她在凌晨两点因为够短而选用的函数名。不同的变量前缀,相同的逻辑。

她打开笔记本电脑查看。她本地的 .git 文件夹里有那些提交——但那是她的笔记本电脑。她的 GitHub 仓库显示提交日期,但那些日期存在于她无法控制的服务器上,任何拥有管理员令牌的人都可以改写。她与客户的 Slack 消息证明她交付了某些东西,而不是其中的内容。

这就是自由职业者困境的一个缩影:作品无可否认是你的,然而没有任何一件东西会被律师、仲裁员或法官当作证据。

本文讲的是在纠纷开始之前弥合这一差距。因为诚实的真相是,一旦竞争对手的仓库里有了你的逻辑,唯一重要的就是你能就过去的某个日期证明什么。

真正的问题:多了几步的“他说,她说”

自由职业代码纠纷很少看起来像戏剧性的法庭揭露。它们看起来是这样的:

  • 客户声称某个里程碑没有按时交付,因此扣留尾款。
  • 一位前客户推出了几乎相同的产品,并称之为“独立开发”。
  • 你发布在 GitHub 上的一个库,未经署名地出现在某人的商业 SaaS 中。
  • 一位前客户的新内部开发者“重写”了你的模块,新的提交历史从头开始,与你作品没有任何关联。

在每一种情况下,问题都不是“这是你写的吗?”而是**“你能证明它在某个具体日期存在,而不依赖对方也控制的系统吗?”**

本地 Git 日志、邮件往来、截图和 Google Drive 时间戳都有一个致命的共同点:它们可以被编辑、伪造,或者干脆被当作自利之词而不予采信。这就是密码学先存技术存在的原因——同样的理念在什么是密码学先存技术?软件团队指南中有所介绍。如果你想要完整的概念背景,请阅读那一篇。在这里,我们保持务实。

试图保护自由职业代码免遭抄袭的目标不是保密。你并没有隐藏任何东西。它关乎对一个问题给出可被数学检验的答案:这段确切的代码是否在这个确切的时间存在?

2026 年的务实答案是 Timestamp GIT:一个 GitHub App,每晚自动将你的提交哈希锚定到比特币区块链。无需 CLI 仪式,无需区块链理论,无需改变你写代码的方式。你安装一次,现有的作者身份证明就会在你睡觉时不断累积。

为什么自由职业者格外脆弱

代理机构有律师审阅的合同。企业有专利组合和合规团队。自由职业者有一个叫 contracts/ 的文件夹和一份 PDF 的模糊记忆。

这种不对称造成了四个具体风险:

没有法务部门。 你无法为一个实用模块的专利申请合理支出 15,000 美元,更绝对无力承担两年的诉讼费用。你需要的是作为正常工作副产物产生的、廉价且高保证度的证据——而不是一种你必须预先出资的法律策略。

脆弱的证据。 在纠纷中,对方的律师会问一个问题:“谁控制这份日志?”如果答案是“主张权利的一方”,证据分量就会下降。GitHub 提交日期是可变的;拥有正确令牌的仓库所有者可以改写历史。内部记录会被定性为自利之词。

作品集与库的风险。 自由职业者会复用。一个日期选择器辅助函数、一套发票编号方案、一个重试包装器——这些会在项目之间流转。当它们未经署名地出现在别人的产品中时,你没有任何机制来确立优先权。GitHub 上的署名是一种社会惯例,而不是法律惯例。

关于交付日期的客户纠纷。 当你的发票上写的是 3 日时,“我们直到 14 日才收到代码”是一句代价高昂的话。一份经里程碑验证、以密码学锚定的提交历史,用一张截图就能终结这场争论。

你的纠纷前行动手册

这是清单。设置大约需要十分钟,然后它就会自行运行。

第 1 步 — 安装 GitHub App

在你想要保护的仓库上安装 Timestamp GIT GitHub App。在标准模式下,该 App 对你的源仓库拥有只读访问权限,对一个专用目标仓库(或同一仓库中专用的 timestamps 分支)拥有读写访问权限。证明产物落在那里,与你的工作历史分开。

这意味着该 App 只读取你所监控仓库的 HEAD 提交哈希。它不需要将你的源代码树复制到任何地方。

如果你在客户拥有的仓库上工作,连只读权限都无法授予,那正是 Enterprise ZK 模式的用武之地——下文有更多介绍。

第 2 步 — 像往常一样继续提交

没有新命令。没有需要记住的 pre-commit 钩子。没有“我给这个打戳了吗?”

一旦安装该 App,它就会通过 webhook 检测新提交,并将提交哈希排队等待处理。提交粒度遵循你的自然工作流程——包括那些凌乱的提交、修正提交,以及你后来压缩掉的“wip”。它们全都是曾经存在过的代码的时间戳。

第 3 步 — 让每晚锚定自动发生

每晚,一个 cron worker 会收集待处理的哈希,将它们分组,并为每个仓库生成一个清单文件(.txt),其中包含当天的提交哈希。它在这些哈希之上构建一棵 Merkle 树,并通过公共 OTS 日历,使用 OpenTimestamps 协议将 Merkle 根锚定到比特币区块链中。

由于是批量处理,无论你一天推送多少提交,成本和链上占用都保持极小。由于是每晚自动进行,你不可能忘记它——而这正是任何手动时间戳例行程序最大的失败模式。

注意时间安排:比特币确认通常需要大约三个小时,因此证明文件会在每晚任务运行几小时后写回。你无需做任何事。

第 4 步 — 领取你的收据

清单和相应的 .ots 收据文件会被推送回你的目标仓库——一个专用的 timestamps 分支或影子仓库。那就是你的证据包:

  • 列出当天提交哈希的 .txt 清单
  • 一个或多个将该清单绑定到某个比特币区块的 .ots 收据文件
  • 一条回溯到具体区块和交易的路径

你可以自己从提交列表重新生成清单哈希,这意味着你并不信任一个黑箱。证明依赖于 SHA-256 和比特币区块数据,而不是某种专有格式。

第 5 步 — 公开证明

在你的 README 中嵌入一个验证徽章。该徽章链接到你仓库的公开验证页面,显示证明存续时间、最早锚定日期、每日规律性,以及其背后的比特币区块和交易数据。

抄袭者会挑选软目标。一个 README 中展示着实时、可独立核验的锚定历史的仓库不是软目标。对于潜在客户来说,这也是一个不错的作品集信号:你的作品带有证明链,而不仅仅是一张提交图。

你可以从仓库的连接页面或通过 API 获取徽章标记:

curl -s "https://timestampgit.dev/api/statusSummary/your-user/your-repo"

私有仓库会在其状态 URL 后附加一个加密的 HMAC,因此只有授权用户才能查看它们——徽章本身是公开的,底层统计数据则限定在该实例范围内。

应避免的事项

不要仅依赖 Git 日志或托管提交日期。 它们存在于你并非独家控制的机器和账户上,一个坚定的对手可以编辑或否认它们。它们作为背景有用,但不是证明。

不要自己动手搞密码学。 运行原始的 OpenTimestamps 工具并手动搬弄 .ots 文件是艰难的做法——它需要专业知识,很容易做错,而且漏掉一步就会使链条失效。Timestamp GIT 的存在正是为了将这一切自动化。你仍然可以用标准工具在本地验证证明,这在如何独立验证 Git 提交时间戳中有所介绍——但你不应该必须去构建它们。

不要等到纠纷发生。 时间戳是过去的一张照片。它无法被追溯拍摄。如果你读到这里是因为已经出了什么问题,今天就安装该 App,让接下来的六个月得到覆盖,并检查你早先的作品是否位于受监控的仓库中。

不要把你的源代码发送给时间戳服务。 有些服务要求宽泛的仓库访问权限。你不需要那样。Timestamp GIT 的架构是零知识的:它只处理提交哈希,从不处理你的代码。在 Enterprise ZK 模式下,连哈希都是通过一个 12 行的 GitHub Action 从你自己的基础设施向外推送的,该服务从不对源仓库拥有读取权限。

不要只打一次时间戳就认为大功告成。 单个证明只保护单个时刻。对自由职业者来说,价值来自连续性:一段每日锚定历史,展示代码在你手中历经数月不断演进。

具体如何运作

两种部署模式

标准模式 — GitHub App。 该 App 只读取你所监控仓库的 HEAD 提交哈希,然后将证明产物写入一个单独的分支或影子仓库。在权限方面,你对源仓库授予只读,对目标仓库授予读写——这反映了 GitHub 权限系统的运作方式,因为并不存在仅限提交哈希的授权。

Enterprise ZK 模式 — GitHub Action。 一个简短的工作流在你自己的 runner 上运行,只将提交哈希推送到 Timestamp GIT API。该服务只需要对目标仓库的读写访问权限,对源仓库则完全不需要。你的源代码永远不会离开你的环境。对于受严格保密条款约束的客户拥有的仓库,或本地部署环境,这种模式至关重要。

端到端流水线

  1. 提交检测 — App 通过 webhook 捕获新提交,或者你的 Action 直接推送哈希。
  2. 哈希队列 — 哈希存放在内存键值存储中,等待批处理窗口。
  3. 每晚 cron — 待处理的哈希被分组,按仓库构建清单,构造 Merkle 树,针对公共日历创建 OTS 证明,并将 Merkle 根锚定到比特币中。
  4. 证明交付 — 清单和 .ots 收据在几小时后、比特币交易确认后,被提交回你的目标仓库。

验证路径

三种证明日期的方式,仪式感依次递增:

  • 公开仪表板 — https://timestampgit.dev/status/{user}/{repo},用于一目了然地查看锚定、最早日期和规律性,并可下载审计 CSV 和 PDF 证书。
  • 浏览器内验证 — https://timestampgit.dev/verification/{user}/{repo}/{date} 逐步走过多层 Merkle 链。所有计算都在你的浏览器本地进行;没有人——包括我们——能看到你验证的内容。
  • 本地验证 — 下载 .ots 文件,并用标准 OpenTimestamps 工具对照比特币区块数据进行检查。没有供应商锁定。

对于 API 驱动的工作流,你需要的一切都只是一个普通的 GET:

# What's the latest anchored Bitcoin block for this repo?
curl -s "https://timestampgit.dev/api/statusLast/your-user/your-repo"

# Full Merkle chain data for a specific day
curl -s "https://timestampgit.dev/api/verify/your-user/your-repo/2026-10-01"

# Download the complete audit ledger as CSV
curl -s -o audit.csv "https://timestampgit.dev/api/audit/your-user/your-repo"

那份 CSV 就是你交给律师的产物。它也是当客户对发票沉默不语时,你附在里程碑邮件中的产物。

Docker 自托管:最大控制权

有些自由职业者在 NDA 下工作,任何第三方 SaaS 都不可行,或者身处真正的气隙环境中。对于这些情况,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 许可证页面申请一个限时演示许可证,提供你的姓名、公司、电子邮件和可选电话号码。许可证文件可立即下载。

常见问题

使用 Timestamp GIT 需要改变我的 Git 工作流程吗? 不需要。一旦你安装 GitHub App,对受监控仓库的每次提交都会每晚自动锚定到比特币。你照常工作——无需 CLI 工具,无需手动步骤。

如果我已经把代码交付给客户,还能证明所有权吗? 可以,前提是你在纠纷发生前已将代码提交到由 Timestamp GIT 监控的仓库。.ots 收据和比特币区块时间戳可作为该日期存在性的不可变证明。

如果客户声称代码是他们写的怎么办? 你的密码学证明——锚定在比特币区块链中——以数学方式证明你的提交哈希在特定时间存在,使任何人极难声称他们先写了它。

我的源代码在 Timestamp GIT 中安全吗? 安全。Timestamp GIT 采用零知识架构:它只处理提交哈希,从不处理你的实际源代码。在 Enterprise ZK 模式下,连哈希都是从你自己的基础设施推送的。

费用是多少? 开源层级对公共仓库免费。Pro Agency 为每月 49 美元,涵盖私有仓库——这是大多数自由职业者相关的方案。Enterprise ZK 为每月 199 美元。详情见定价页面。

在需要之前就开始

自由职业代码纠纷令人不安的算术是:证据只有在你当时创建了它才存在。你无法追溯证明某个函数在三月存在过。你只能证明它从你开始锚定的那一刻起存在。

安装 GitHub App,连接存放你可复用库和客户交付物的仓库,让每晚任务完成其余工作。一个月内,你就会拥有一份连续的、以比特币锚定的作者身份记录。一年内,你就会拥有竞争对手无法争辩、客户无法改写的东西。

现在花十分钟,还是以后来一场他说她说的争吵。这就是全部的取舍。

相关文章

EU label: AI-generated content