Timestamp GIT

← All posts

2026-10-14

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

自由职业者如何在纠纷发生前证明代码所有权
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 上的署名是一种社会惯例,而非法律惯例。

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

你的纠纷前行动手册

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

第 1 步 — 安装 GitHub App

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

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

如果你在客户拥有的仓库上工作,连只读权限都无法授予,那正是 Enterprise ZK 模式的用途——详见下文。

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

没有新命令。没有需要记住的 pre-commit 钩子。没有“我盖章了吗?”

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

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

每晚,一个 cron 工作进程收集待处理的哈希,将它们分组,并为每个仓库生成一个清单文件(.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。 一个简短的工作流在你自己的运行器上运行,只将提交哈希推送到 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