Timestamp GIT

← All posts

2026-11-20

通过一次 GitHub App 安装设置 IP 保护

通过一次 GitHub App 安装设置 IP 保护
timestamp git blockchain proof

通过一次 GitHub App 安装即可设置知识产权保护

你不需要法律预算、命令行工具链,也不需要改变团队的代码编写方式,就能获得密码学证明,证实你的仓库在某一特定时刻已经存在。你只需要安装一次。

本指南完整介绍 用于知识产权保护的 GitHub App 的整个设置流程:安装 Timestamp GIT GitHub App,选择你的仓库,让夜间自动化任务批量处理你的提交哈希并将其锚定到比特币中,然后确认证明真实有效。下面的每一步都是一次点击、一项设置或一个简短的配置文件。你的团队中没有任何开发者需要输入新命令,也没有任何源代码会离开你的 GitHub 组织。

你最终会得到:每天一份不可篡改的 .ots 收据、一个由比特币区块数据支撑的公开状态页面、README 中的一个徽章,以及一份可以交给律师或审计员的审计 CSV 或 PDF 证书。

为什么 GitHub App 是获得知识产权保护的最快途径

困难的做法是自己手动锚定提交——手动运行 OpenTimestamps 工具,并为每一批跟踪比特币确认。这可行,但容易出错,依赖于某个人记得去做,而且一旦你有五名开发者、每天上百次提交,这种做法就会崩溃。

托管的方式则是安装一个 GitHub App。Timestamp GIT 建立在相同的密码学原语之上,但将协议隐藏在自动化之后:

  • 安装一次。 无需 CLI,无需本地工具,开发者的机器上无需安装任何东西。
  • 自动检测。 通过 webhook 捕获受监控仓库中的每一个新提交。
  • 夜间锚定。 哈希在午夜批量处理,构建 Merkle 根,并通过 OpenTimestamps 锚定到比特币中。
  • 回传给你。 清单和 .ots 收据会写入一个专用分支或一个独立的影子仓库。
  • 零知识。 只处理提交哈希。你的源代码永远不会被读取、复制或存储。

如果你希望在开始点击之前了解这件事在法律上为何重要的战略背景,请阅读申请专利前证明在先技术:创始人指南。本文只聚焦于设置。

前提条件:开始前你需要准备什么

  • 拥有管理员权限的 GitHub 账户,针对你想要保护的仓库——或组织。你无法在只有写入权限的仓库上安装 GitHub App。
  • 一个 Timestamp GIT 账户。 开源层级对公开仓库免费;私有仓库需要付费计划。
  • 对 Git 的基本心智模型。 你应该知道提交有一个 SHA-1 或 SHA-256 哈希。这就是所需的全部密码学知识。
  • 决定证明存放在哪里。 同一仓库的专用分支,或一个独立的影子仓库。影子仓库能让你的主仓库保持整洁,但需要一个你能授予写入权限的目标仓库。
  • 可选:Docker。 仅当你计划稍后自托管时——在后面的章节中介绍。

第 1 步:安装 Timestamp GIT GitHub App

  1. 前往 timestampgit.dev 并使用 GitHub 登录。
  2. 点击 Install GitHub App。
  3. 选择 All repositories 或 Only select repositories,然后选择你想要监控的仓库。
  4. 查看 GitHub 向你展示的权限。在标准模式下,该应用需要:
    • 对你的源仓库的只读访问权限——GitHub 不提供仅限提交哈希的访问权限,因此读取权限是最低要求。
    • 对一个用于写入证明的目标仓库的读写访问权限。
  5. 确认。你会进入仪表板,其中列出了已连接的仓库。

你可以随时从 GitHub App 设置页面重新查看和更改仓库选择;该应用无需重新安装即可纳入新添加的仓库。

第 2 步:配置你的仓库设置

选择你刚刚连接的仓库。这里有两个重要决定:

证明存放在哪里? 要么是同一仓库中的专用 timestamps 分支,要么是一个独立的影子仓库。如果你正在为计划稍后开源的仓库打时间戳,影子仓库可以让证明历史在你希望其可见之前不进入公开树。

锚定何时运行? 默认且推荐设置为每晚午夜——将许多提交批量合并为一个 Merkle 根,正是让每日证明成本低廉且一致的原因。保持默认计划几乎总是正确的选择。

然后复制你的徽章嵌入代码。打开仓库连接页面(/connected/{user}/{repo}),查看 Shields.io 验证徽章的实时预览以及要粘贴的确切 Markdown。

一个隐私说明:私有仓库的状态 URL 带有特定于你的服务器实例的加密 HMAC,因此只有授权用户才能读取私有仓库的状态。复制 URL 时不要去掉该参数。

保存设置。提交哈希会立即开始流入队列。

第 3 步:让自动化运行

这里除了推送代码之外无事可做。在幕后:

  1. 提交检测——GitHub App 通过 webhook 看到新提交。
  2. 哈希队列——提交哈希在内存键值存储中累积以进行批处理。
  3. 午夜 cron 工作进程——一个工作进程将所有待处理的哈希分组,为每个仓库写入一个清单文本文件,原生构建 Merkle 树,针对公共 OTS 日历生成 OpenTimestamps 证明,并将 Merkle 根锚定到比特币中。
  4. 证明交付——清单和 .ots 收据文件会被推送回你的 timestamps 分支或影子仓库。

为比特币确认窗口预留时间。批次在午夜提交,但被包含进区块通常需要大约三个小时。实际上,今天推送的提交的证明会在明天早上可用。

再次强调零知识这一点,因为这是审计员会问的问题:该服务只处理提交哈希。你的差异、你的文件、你的机密——这些都不会被传输。

第 4 步:将验证徽章添加到你的 README

将从连接页面复制的代码片段粘贴到你的 README 中。它大致如下——请使用应用给你的确切 URL,而不是占位符:

<!-- Copy the real snippet from timestampgit.dev/connected/{user}/{repo} -->
[![Bitcoin-timestamped](BADGE_URL_FROM_TIMESTAMPGIT)](https://timestampgit.dev/status/your-user/your-repo)

任何点击进入的人都会到达公开状态页面,并可以自己从 .ots 文件重新验证时间戳。这种公开的、可点击进入的验证路径,正是将专有主张转变为第三方会接受的证据的关键。

如何确认它有效

等一个晚上,然后检查三件事。

1. 仓库状态页面。 打开 /status/{user}/{repo}。你应该看到证明的持久性、最早的锚定日期、每日规律性、每个锚定的比特币区块和交易数据,以及一个日历热力图。热力图中的空白意味着当天没有提交——而不是失败。

2. API,如果你想将其放入仪表板。

# Last anchored Bitcoin block
curl https://timestampgit.dev/api/statusLast/your-user/your-repo

# Total stamped commit count
curl https://timestampgit.dev/api/statusCount/your-user/your-repo

# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/your-user/your-repo

3. 特定日期的 PDF 证书。 下载任何已锚定日期的证书:

curl -O https://timestampgit.dev/api/report/your-user/your-repo/2026-11-19

关于 Merkle 链验证实际逐步进行的过程的完整演示——全部在你的浏览器中本地计算——请参阅如何验证你的代码的比特币时间戳证明。简而言之:.ots 文件和清单是标准的 OpenTimestamps 证明,任何兼容工具都可以对照比特币区块数据进行验证。没有锁定,也不依赖于我们是否继续经营。

可选:为气隙环境使用 Docker 自托管

为了获得最大控制权——受监管环境、气隙网络,或希望将服务部署在自己基础设施上的团队——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 许可证页面申请限时演示许可证,提供你的姓名、公司、电子邮件和可选电话号码;你会获得一个可下载的许可证文件。自托管意味着管理你自己的 GitHub App 和基础设施,但零知识保证完全相同。

常见设置问题排查

  • 安装失败或权限看起来不对。 你需要对仓库或组织拥有管理员权限,并且在标准模式下,还必须授予应用对写入证明的目标仓库的访问权限。缺少目标仓库是“已连接但没有任何反应”的最常见原因。
  • 24 小时后没有证明。 确认仓库确实在接收提交,并且应用没有被 GitHub 侧暂停。在提交任何问题之前,先检查状态页面是否有错误——空闲仓库不会产生清单,这是预期行为。
  • 徽章渲染为损坏的图像。 从连接页面重新复制徽章 URL。对于私有仓库,URL 必须包含加密的 HMAC;截断的 URL 会失败。
  • 锚定延迟。 比特币区块时间会变化。延迟的确认仍然会锚定——一旦区块存在,证明就是不可篡改的。无需重新运行任何内容。
  • 证明出现在意外位置。 检查仓库配置的是同仓库分支还是影子仓库;切换模式不会重写历史证明。

常见问题

使用 Timestamp GIT 需要改变我的 Git 工作流程吗? 不需要。安装 GitHub App 后,它会自动检测新提交并每晚锚定它们。开发者继续照常使用 Git——无需学习新命令或工具。

Timestamp GIT 需要哪些 GitHub 权限? 在标准模式下,该应用需要对源仓库的只读访问权限(以读取提交哈希),以及对存储证明的目标仓库的读写访问权限。企业 ZK 模式则通过一个 GitHub Action 来调换这一点,该 Action 仅从你自己的基础设施推送提交哈希,因此服务完全不需要对源仓库的读取权限。

一次提交在比特币上打时间戳需要多长时间? 提交哈希每天午夜批量处理并锚定一次。批次通过 OpenTimestamps 提交到比特币区块链后,确认通常需要大约 3 小时——因此证明通常会在第二天早上可用。

我可以在没有 Timestamp GIT 的情况下独立验证时间戳证明吗? 可以。.ots 收据文件和清单是标准的 OpenTimestamps 证明。你可以使用任何兼容 OpenTimestamps 的工具对照比特币区块链进行验证,从而确保供应商独立性。

安装就是整个项目

一次 GitHub App 安装,一次仓库选择,一个设置页面。之后,知识产权保护就成为你仓库的一个后台属性,而不是每季度的琐事:每个提交哈希每晚批量处理,每个批次通过 Merkle 根锚定到比特币区块中,每份证明写回你控制的分支,并且任何拥有 .ots 文件的人都可以验证。

这就是全部的采用成本。如果你一直因为看起来像附带工程税的法律流程而推迟在先技术保护,今天就在公开仓库上从免费的开源层级开始,明天早上观察第一份证明落地——从这里开始。对于先评估工具格局的团队,供审计员使用的源代码时间戳最佳工具比较了各种选项。

相关文章

EU label: AI-generated content