Timestamp GIT

← Tutti gli articoli

2026-10-21

Come dimostrare la proprietà del codice in una controversia di pagamento con un cliente

Come dimostrare la proprietà del codice in una controversia di pagamento con un cliente
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 证书则将某一天的时戳打包成一份你可以附在邮件中或交给律师的文件。

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

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

5. 为了额外保障:嵌入验证徽章

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

在付款纠纷中应避免什么

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

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

标准模式(GitHub App)。 安装一次,连接仓库,完成。该应用通过 webhook 检测新提交,待处理的哈希会排队等待夜间工作进程处理。你无需做任何事,就能自动将证明交付到你的 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 美元适用于私有仓库,Enterprise ZK 为每月 199 美元,包含 GitHub Action 工作流程。

常见问题

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

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

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

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

时戳需要多长时间才能得到确认?

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

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

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

底线

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

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

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

相关文章

EU label: AI-generated content