开源项目 agent-git-service：为 AI 代理打造的 GitHub 兼容服务

一个名为 agent-git-service 的开源项目近期在 GitHub 上发布，旨在为 AI 代理提供一套自托管、GitHub 兼容的代码托管与协作服务。与传统 Git 服务不同，该项目在协议层面将 AI 代理视为「一等公民」，围绕代理身份、权限模型和恢复流程做了专门设计。

项目定位与核心特性

agent-git-service 暴露 GitHub 风格的 REST v3、GraphQL v4、OAuth 设备流（device flow）以及 Git Smart HTTP 协议，仓库数据以裸 Git 仓库形式存储，产品元数据则使用 TiDB 或 MySQL 兼容的存储后端。这意味着现有的 GitHub 客户端（例如 gh CLI）几乎可以无修改地与之对接。

项目的差异化能力集中在「代理优先」的设计上，主要包括：

• 持久的代理身份（durable agent identities）与可作用域的 API 令牌
• 代理与人类账户的绑定（human-agent binding）、会话切换与恢复流程
• 代理在仓库、组织、团队维度的直接权限授予
• 默认工作区（default workspaces）与仓库移交能力
• 可选的嵌入向量驱动的 Issue / PR 语义搜索

与 GitHub.com 的能力对比

项目维护者提供了一份与 GitHub.com 的逐项对比表，部分关键差异如下：

• 持久代理账户：agent-git-service 支持，GitHub 不支持（仅提供 Bot、App、PAT 与机器用户）
• 代理直接权限：agent-git-service 全量支持跨仓库、组织、团队的协作权限，GitHub 仅部分支持，需依赖 App 或 PAT 间接授权
• 人类与代理绑定及恢复：agent-git-service 视为一等流程，GitHub 不提供
• 自托管与本地数据：agent-git-service 完整支持，GitHub 不支持
• 全功能 GitHub 产品生态（Actions、安全产品、市场、流量分析等）：GitHub 完整覆盖，agent-git-service 仅部分覆盖
• 完整 GraphQL schema 兼容：GitHub 完整覆盖，agent-git-service 仅覆盖选定工作流

部署与开发

项目二进制名为 gh-server，遵循 Apache License 2.0 协议。项目提供基于 TiDB Zero 的本地快速启动方式：通过一条 curl 命令申请一次性 TiDB 实例，并将连接信息注入 DB_DSN 环境变量后即可运行 go run ./cmd/gh-server。生产环境则建议使用 TiDB Cloud Starter 并参考专门的部署文档。

开发侧提供常用 Makefile 目标，包括 make build、make check、make test-unit，以及使用 vendored GitHub CLI acceptance 套件运行的端到端测试 make test。已知与 GitHub API 的兼容差异在 docs/github-api-compatibility-matrix.md 中持续跟踪。

适用场景与局限

对于希望把代码仓库、代理身份与权限数据保留在自有基础设施内的团队，agent-git-service 提供了一条轻量路径，让既有 GitHub 工具链可以继续工作。但需要注意的是，它目前并不试图复刻 GitHub 的完整产品生态，Actions、安全、Marketplace 等长尾能力仍需依赖 GitHub 本身，更适合作为「代理运行时」的本地协作底座，而非 GitHub 的全功能替代品。