Git.Top

Git.Top

开源软件的知识图谱。

GitHub 提供代码。Git.Top 提供知识。

Git.Top 将非结构化的 GitHub 仓库数据转化为结构化的项目信息，供人类和 AI Agent 搜索、比较、推荐、评分，并通过 REST API 或 MCP 工具调用。

Cloudflare Worker 是唯一的产品界面。它提供面向用户的 HTML 页面、REST API、MCP 端点、GitHub 同步，以及由 D1 支持的知识数据。

生产环境：git.top

仓库：github.com/haocn-ops/git-top

连接 Agent

如需最快完成首次连接，请使用精简版 MCP 配置：

codex mcp add git-top --url https://git.top/mcp/core
claude mcp add --transport http --scope user git-top https://git.top/mcp/core

然后向你的 Agent 提问：

Use Git.Top to recommend three open-source browser-agent projects for Docker, then cite the data source and one caveat for each.

完整设置、客户端状态和 REST 替代方案：git.top/connect。

标注日期的兼容性证据，以及配置验证与真实客户端支持之间的区别：git.top/compatibility。

可用于注册表的文案、配置文件、隐私边界、活动链接和提交状态：git.top/distribution.json。另提供可安装的 REST 优先 Agent Skill：skills/git-top-project-selection。

Git.Top 的功能

• 按类别、部署目标和使用场景发现开源 AI 项目。
• 通过决策摘要、排名信号和权衡项比较项目。
• 根据相似性信号和便于比较的候选清单查找替代方案。
• 探索项目之间的关系，包括替代方案、相关项目、依赖项、部署方式和使用场景。
• 说明 Git.Top Score、Agent Score、质量信号、风险标记和证据。
• 提供面向 Agent 的 REST、OpenAPI、llms.txt、llms-full.txt 和 MCP 接口。

产品界面

• /discover - 浏览 AI Agent、MCP 服务、RAG、浏览器自动化和 AI IDE 项目。
• /recommend - 根据使用场景和约束条件生成可解释的项目候选清单。
• /compare - 比较项目候选清单。
• /alternatives 和 /alternatives/:project - 查找替代候选项目。
• /graph/:project - 查看项目知识图谱。
• /score/:project - 说明项目评分维度。
• /atlas - 探索生态图谱。
• /api/* - 获取结构化知识。
• /mcp - 通过 MCP 连接 Agent。
• /mcp/core - 连接包含五个工具的精简版 MCP 配置，适合初次使用。

架构

GitHub API
  -> Git.Top ETL
  -> Cloudflare D1
  -> Worker pages, REST APIs, MCP tools, sync jobs, and quality gates

本项目有意不提供独立的 Next.js 应用。将由 Worker 渲染的页面、API、同步、D1 访问、OpenAPI 和 MCP 保持在同一个运行时中，可避免产品行为出现分歧。

文档

• 编码 Agent 指南
• AI Agent 采用与分发计划 2026-07-31
• Agent 客户端兼容性
• Agent 分发包
• Agent 原生化评估与优化计划
• 竞争分析与 90 天优化计划 2026-09-02
• Agent 功能测试与改进计划 2026-07-30
• 生产环境数据新鲜度优化计划 2026-07-14
• 网站评估与改进计划 2026-07-12
• 自动化运营与 Agent 友好性计划 2026-07-12
• Agent 任务评估
• Agent 原生化优化实施报告
• Agent 原生化优化 PR 摘要
• Git.Top 2.0 产品升级计划
• 下一阶段计划
• Agent 友好性优化计划
• 部署决策
• REST API 指南
• MCP 指南
• MCP 工具行为示例
• MCP 一致性矩阵
• 面向 SDK 的示例
• 采用情况分析操作手册
• GRP 示例
• Agent 快速入门
• MailAgents Agent 工作流文章
• 网站评估 2026-06-21
• 生产环境操作手册
• 运营与数据治理计划
• 公开信任基准：/benchmark 和 /api/benchmark
• 数据覆盖报告
• 种子数据在线检查报告
• 评估质量报告
• 本地评估报告
• 排名实验
• 质量加固计划
• V1 后续改进计划
• 贡献指南
• 安全
• 许可证

开发

维护 Agent 请从 AGENTS.md 开始。该文件概述了运行时、高风险区域、生成的数据和验证层级。

快速检查：

pnpm docs:validate
pnpm check

Agent 接口检查：

pnpm api:validate
pnpm mcp:validate
pnpm eval:explanations
pnpm check

数据和本地 D1 检查：

pnpm db:execute
pnpm db:seed
pnpm db:integration

发布检查：

pnpm validate
pnpm release:check

常用开发命令：

pnpm install
pnpm db:execute
pnpm db:seed
pnpm seed:validate
pnpm seed:coverage
pnpm seed:candidates
pnpm seed:live-check -- --limit 20
pnpm seed:live-check -- --offset 20 --limit 20
node scripts/run-governance-task.mjs daily-production-health
pnpm knowledge:validate
pnpm db:seed-sql
pnpm db:validate
pnpm db:integration
pnpm core:validate
pnpm api:validate
pnpm mcp:validate
pnpm eval:quality
pnpm eval:explanations
pnpm eval:local
pnpm eval:ranking
pnpm eval:agent-tasks
pnpm smoke:prod
pnpm release:check
pnpm check
pnpm validate
pnpm quality:check
pnpm dev

/api/health 会报告 D1 可用性和当前项目数量。如果 D1 为空，请在本地 API 检查前运行 pnpm db:execute 和 pnpm db:seed。pnpm db:execute 会准备本地 D1 架构，并为较旧的本地数据库补齐可能缺失的可选列。seed.sql 根据手工编写的种子知识和生成的评估固定数据生成；更改这些固定数据后，请运行 pnpm db:seed-sql。pnpm db:integration 会为本地 D1 填充种子数据、启动临时本地 Worker，并验证由 D1 支持的 HTTP API 路径。

pnpm eval:quality 是适用于 CI 的推荐与分类回归门禁。pnpm eval:explanations 会检查面向 Agent 的响应是否包含来源元数据、分类依据、质量信号置信度、推荐理由与权衡、健康检查数量语义以及 GRP 推理。pnpm eval:agent-tasks 会对完整的信任、回退、分页、证据、比较、变更源、反馈、多语言、拼写错误和别名工作流进行门禁检查，并写入 docs/AGENT_TASK_EVAL.md。pnpm eval:local 会针对由固定数据支持的项目集运行更广泛的生成式类别和部署探测，并写入 docs/EVAL_LOCAL.md；调整排序启发式之前请使用它，但不要将它纳入默认验证流程。pnpm eval:ranking 会在 docs/RANKING_EXPERIMENTS.md 中比较离线排序策略。运行时搜索默认采用精确意图排序；范围较广的限定范围发现可选择 ranking=browse。

pnpm seed:candidates 会从实时 GitHub 组织元数据中发现种子扩展候选项，并写入 docs/SEED_CANDIDATES.md。请将其视为审核队列，而不是自动追加步骤；候选项仍需经过实时检查和类别审核，才能加入 data/seed-repositories.json。

pnpm smoke:prod 会验证已部署在 https://git.top 的 Worker，并要求响应由 D1 支持。要检查本地或预览 Worker，请使用 pnpm smoke:prod -- --base-url http://localhost:8787；只有在有意检查种子回退行为时，才添加 --allow-seed。

默认情况下，pnpm quality:check 会验证 https://git.top 上的生产 /api/quality 端点，要求元数据由 D1 支持，并使用默认最低分数 90。预览和回退检查可使用 --base-url、--target、--min-score 或 --allow-seed。

运维和数据治理功能通过 /operations、/api/governance/summary 和 /api/governance/runs 提供。Cloudflare Worker 的 Cron 每小时运行维护任务，并运行每日、每周、每两周和每月的治理检查，然后将结果记录到 governance_runs。

pnpm release:check 会运行公开 V1 发布门禁：本地验证、本地 D1 集成、生产质量检查和生产冒烟测试。只有在生产部署尚不存在、需要验证构建时，才使用 pnpm release:check -- --skip-prod-smoke；此命令会跳过仅适用于生产环境的检查。使用 pnpm release:check -- --base-url <origin> 可针对 Worker 预览环境或本地源运行相同的门禁。

更新现有 D1 数据库时，请先应用 migrations 中的 SQL 文件，再部署会读取新列的代码。

同步

Git.Top 可以通过 GitHub API 将真实仓库数据同步到 D1。

生产环境所需的密钥：

wrangler secret put GITHUB_TOKEN
wrangler secret put SYNC_SECRET

本地开发时，将 .dev.vars.example 复制为 .dev.vars，并填入真实值。

触发受保护的本地或生产环境同步：

curl -X POST http://localhost:8787/api/admin/sync \
  -H "authorization: Bearer $SYNC_SECRET" \
  -H "content-type: application/json" \
  -d '{"limit": 40, "offset": 0, "signal_depth": "lite"}'

在查看近期的 /api/sync/status 运行记录后，手动补同步时使用 {"limit":40,"signal_depth":"lite"}。Cron 使用较小的轻量批次，以避免超过 Worker 子请求限制；手动补同步的上限仍为 50。

运行多轮生产环境补同步：

SYNC_SECRET=... pnpm sync:prod:catchup --rounds 13 --limit 40

省略 offset，即可使用已存储的种子游标。Cron 同步会使用此游标，并按有界批次遍历种子列表。 当所有种子仓库都已建立索引，但新鲜度恢复仍需遍历完整种子游标（尽管 remaining_count=0）时，添加 --refresh-cycle。

API

• GET /api/project/:owner/:name
• GET /api/health
• GET /api/quality
• GET /api/benchmark
• GET /api/governance/summary
• GET /api/governance/runs
• GET /api/sync/status
• GET /api/schema/agent-card.v1
• GET /api/schema/project-knowledge.v1
• GET /api/search
• GET /api/trending
• GET /api/category/:name
• GET /api/recommend
• GET /api/compare
• GET /api/alternatives/:owner/:name
• POST /api/grp/query
• POST /api/admin/sync
• POST /api/admin/alternatives
• POST /api/admin/governance/runs

V1 开发规范见 git_top_v1.md，GRP v1 推理协议实现规范见 git_top_grp_v1.md。

许可证

MIT