Timestamp GIT

← All posts

2026-10-21

如何在客户付款纠纷中证明代码所有权

如何在客户付款纠纷中证明代码所有权
timestamp git blockchain proof

如何在客户付款纠纷中证明代码所有权

你在周五交付了功能完整的构建版本。三个冲刺、四个月、一份签署的工作说明书。周一客户没了音讯。两周后他们的运营经理写道:“我们从未收到最终代码,而且我们看到的东西并不符合约定。” 然后发票就停了。

这是每个自由职业者和小型代理机构都害怕的时刻,也正是这个时刻,懂得如何在客户付款纠纷中证明代码所有权不再是一个理论问题,而成为拿到报酬与白白损失四个月工作之间的分水岭。

自由职业者的噩梦:当客户拒绝付款

这个场景几乎以机械般的规律反复上演:

  • 你推送了最后一次提交,移交了访问权限,发出了最后一张发票。
  • 客户对范围提出异议,声称未交付,或者在验收两个月后编造出一份缺陷清单。
  • 他们有一位常聘律师。而你只有一个 Gmail 账号和一个 Notion 页面。

核心问题不在于你错了。而在于如果没有关于交付了什么以及何时交付的独立证明,纠纷就会沦为一场可信度较量——而可信度较量总是由钱更多、文件更齐全的一方获胜。

Timestamp GIT 正是为这种情况准备的自动化安全网。它是一个 GitHub App:你只需在仓库上安装一次,之后你做的每一次提交都会在一夜之间被加密锚定到比特币区块链中,无需 CLI 工具,也无需手动操作。你照常工作;证明在后台不断累积。当客户纠纷开始时,你无需争论日期——你直接交出一份可验证的凭证。

本文聚焦于付款纠纷这一使用场景。关于更广泛的前案证据图景——专利流氓、员工纠纷、洁净室抗辩——请参阅文末的相关文章。

为什么传统证据在付款纠纷中会失效

大多数开发者以为他们的 Git 历史就是证据。其实不是,至少单靠它本身不是:

  • Git 提交日期不是可信证据。 提交者和作者日期只是元数据。任何拥有写入权限的人都可以改写历史,而且即便不改写,开发者在自己的机器上输入的日期字段对第三方来说也证明不了任何东西。
  • 历史记录存放在你无法控制的服务器上。 GitHub 上的内容可以被编辑、强制推送,或者——最糟糕的情况——如果仓库属于客户,你可能会完全失去访问权限。
  • 邮件往来和聊天记录很容易被伪造或删除。 一张 Slack 消息的截图分量极轻。
  • 内部日志会被视为自说自话而不予采信。 在法律审计中,“我们自己的数据库显示我们已经交付了”这句话的说服力,大致相当于一张手写便条。

法院、调解员和仲裁员寻找的是不同的东西:独立的、防篡改的、第三方无需信任任何一方即可验证的证明。

这正是比特币锚定所提供的东西。Timestamp GIT 的证明通过 OpenTimestamps 协议锚定在比特币区块链中。一旦某个哈希在区块中得到确认,地球上没有任何实体能够更改或伪造它——包括运营该服务的公司。Timestamp GIT 明天就可能消失,而你的证明仍然可以由你或任何其他人离线验证。

行动手册:如何在纠纷发生前和纠纷期间保护自己

1. 项目开始前:安装 GitHub App

在你将要工作的仓库上安装 Timestamp GIT GitHub App——你自己的仓库,或者经客户许可后客户的仓库(更多内容见 FAQ)。这就是全部设置。无需在开发者的机器上安装 CLI 工具,也无需改变工作流程。

在标准模式下,该应用只读取受监控仓库的 HEAD 提交哈希。它需要对源仓库的只读访问权限,以及对目标仓库的读写访问权限,目标仓库可以是同一个仓库,也可以是单独的仓库。

2. 项目进行中:照常提交即可

这一点对纠纷至关重要:你的提交信息就是交付过程的叙述。引用合同。

git checkout -b feature/checkout-flow

git add .
git commit -m "feat: complete checkout flow per SOW section 4.2"
git push origin feature/checkout-flow

这就是你唯一需要改变的地方。每晚,Timestamp GIT 会将待处理的提交哈希分组,为每个仓库创建一个清单(.txt),构建一棵 Merkle 树,使用公共日历生成 OpenTimestamps 证明,并将 Merkle 根锚定到比特币中。清单和 .ots 凭证文件会被推送回你的仓库,存放在专用的 timestamps 分支或影子仓库中。

有一件事需要提前规划:比特币确认通常需要大约 3 小时,所以证明文件会在夜间运行几小时后才落地。不要把你需要凭证的那个晚上安排成交付时间。

3. 如果发生纠纷:提取证据

你的仓库状态页面会显示证明的存续时长、最早的锚定日期、每日规律性,以及每一天背后的比特币区块和交易数据。你可以从中导出在账单讨论中至关重要的两份文件:

# Full audit ledger for the whole engagement, as CSV
curl -L "https://timestampgit.dev/api/audit/youruser/client-project" \
  -o audit-ledger.csv

# PDF certificate for one specific delivery date
curl -L "https://timestampgit.dev/api/report/youruser/client-project/2026-10-14" \
  -o certificate-2026-10-14.pdf

CSV 为你提供确切的提交及其比特币区块确认——一份逐日的交付记录。PDF 证书将某一天的 timestamp 打包成一份你可以附在邮件中或交给律师的文件。

4. 出示证据,而不是争论证据

发送 .ots 凭证文件和验证链接。关键在于客户——或他们的律师——不必信任你。他们可以使用标准的 OpenTimestamps 工具,独立地对照比特币区块链核验 timestamp。Timestamp GIT 还提供一个网页查看器,逐步展示多级 Merkle 链,所有计算都在你的浏览器本地完成,因此没有人能看到你验证的内容。

5. 如需额外保障:嵌入验证徽章

仓库状态页面提供可嵌入 README 的徽章。一个可见的“提交已锚定到比特币”徽章传递出专业感,并悄悄告诉潜在的争议发票方:这份交付记录不是靠争论就能推翻的。徽章 URL 和现成的 Markdown 片段可在安装后从已连接仓库页面获取。

在付款纠纷中应避免什么

  • 不要仅依赖 GitHub 的提交历史。 它可以被更改,而且会被定性为自报证据。
  • 不要等到纠纷开始才设置 timestamp。 证明只有在冲突发生之前就已存在才可信——追溯性的证明是不可能的。
  • 不要在纠纷期间把整个代码库甩给客户。 Timestamp GIT 的零知识设计意味着你可以分享哈希证明和证书,而不是源代码,除非法院强制要求。
  • 不要自己动手实现密码学。 你可以尝试手动组装 OpenTimestamps 证明链——那是艰难的方式,而且工作流程中一个错误就会让你一无所有。托管的 GitHub App 会自动处理检测、批处理、锚定和交付。

Timestamp GIT 如何融入你的工作流程

标准模式(GitHub App)。 安装一次,连接仓库,完成。该应用通过 webhook 检测新提交,待处理的哈希会排队等待夜间 worker 处理。你无需触碰任何东西,就能自动获得证明交付到你的 timestamps 分支。

企业 ZK 模式。 对于希望哈希永不离开自身基础设施的团队,一个 12 行的 GitHub Action 在你的环境中运行,只将提交哈希推送到 Timestamp GIT API。在此模式下,不需要对源仓库的读取权限——你只需安装该 Action。

自托管。 对于气隙或高度受监管的环境,Timestamp GIT 以 Docker 镜像形式发布,可通过 Docker License 页面获取限时演示许可证。一个快速上手的 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 并配置实例。

验证。 无论你运行哪种模式,验证方式都相同:下载 .ots 文件,使用标准的 OpenTimestamps 工具对照比特币区块链核验,或者使用查看器和 PDF 报告。证明仅依赖于 SHA-256 和比特币区块数据——没有专有技术,没有锁定。

定价也遵循同样的形态:开源版对公共仓库免费,Pro Agency 版对私有仓库为 $49/月,企业 ZK 版为 $199/月,附带 GitHub Action 工作流程。

FAQ

如果客户拥有仓库,我还能使用 Timestamp GIT 吗?

可以。你可以在客户许可后在其仓库上安装 GitHub App,或者设置一个由你控制的影子仓库。在标准模式下,该应用需要对源仓库的只读访问权限,以及对目标仓库的读写访问权限(目标仓库可以是同一个或单独的仓库)。在企业 ZK 模式下,你基础设施上的 GitHub Action 只推送提交哈希,因此不需要对源仓库的读取权限。

如果客户删除了仓库怎么办?

你的证明是安全的。Timestamp GIT 会将清单和 .ots 凭证文件推送到由你控制的专用 timestamps 分支或影子仓库。此外,比特币区块链记录是永久且不可篡改的。即使客户删除了他们的仓库,你仍然保留着提交的加密证明。

timestamp 确认需要多长时间?

比特币确认通常需要大约 3 小时。Timestamp GIT 每晚批处理提交,将 Merkle 根锚定到一笔比特币交易中,然后将证明文件写回你的仓库。在夜间运行后的几小时内,你就会获得一个可验证的 timestamp。

Timestamp GIT 在法庭上可被采信吗?

Timestamp GIT 使用全球公认的加密标准提供法庭就绪的证据:SHA-256 哈希、OpenTimestamps 协议和比特币区块链。这些证明不可篡改,且任何人都可以独立验证。然而,可采信性取决于司法管辖区和具体法律背景,因此请咨询合格的律师。

底线

付款纠纷在成为法律问题之前,首先是一个文档问题。能拿到报酬的开发者,是那些能够指向一份双方都无法控制的记录并说:这就是当时存在的东西,而这就是证明它的区块。

这就是为什么要在下一次合作之前而非下一张未付发票之后安装 GitHub App 的全部理由。它只需一次安装,不改变你的日常工作流程,并将你正常的提交历史转变为任何客户、律师或调解员都无法争辩的证据。

从你的下一个仓库开始——公共仓库免费,无论哪种方式都只需几分钟的设置。

相关文章

EU label: AI-generated content