Release Notes Index

Name: Release Notes Index
Author: releases.sh

远程服务

github.com/buildinternet开发工具11今天更新

代码仓库

关于 Release Notes Index

Release Notes Index 汇集并规范化各厂商的版本说明，供开发者和 Agent 查询。它保存原文，并提供 AI 摘要、变更分类以及 MCP、CLI 和 REST API 接口。

主要功能

01汇集多种来源的版本说明
02统一格式并保留原文
03生成摘要与破坏性变更分类
04组织近期发布概览
05提供 MCP、CLI 与 REST API

适用场景

01升级前检查产品变更
02排查事故后追踪版本调整
03跨厂商搜索版本说明
04导出组织发布信息

MCP 相关

托管的 MCP 服务位于 agents.releases.sh/mcp，可供 MCP 客户端查询版本索引。读取无需账户或 API 密钥。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://agents.releases.sh/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http sh-releases https://agents.releases.sh/mcp

Cursor.cursor/mcp.json{"mcpServers":{"sh-releases":{"type":"http","url":"https://agents.releases.sh/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"sh-releases":{"type":"http","url":"https://agents.releases.sh/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"sh-releases":{"type":"http","url":"https://agents.releases.sh/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"sh-releases":{"serverUrl":"https://agents.releases.sh/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
kind	enum	否	筛选特定的来源/产品类型。版本发布结果通过 `source.kind ?? product.kind` 解析类型；目录结果按行自身的类型筛选。组织和集合部分不受影响；变更日志分块结果不受影响。platform \| sdk \| mobile \| desktop \| docs \| integration \| tool
mode	enum	否	版本发布检索策略。'hybrid'（默认）融合 FTS + 向量结果。'lexical' 仅使用旧版 FTS。'semantic' 仅使用向量。向量基础设施不可用时回退到词法模式。lexical \| semantic \| hybrid
type	array	否	要返回的部分。省略则返回全部四个部分。用于跳过耗时的路径，例如 ['catalog'] 用于仅查询注册表，['releases'] 用于纯版本发布搜索，['collections'] 用于快速查找播放列表。
limit	number	否	每个部分的最大结果数（默认 20）
query	string	是	搜索查询
since	string	否	仅保留在此界限当天或之后发布的版本结果。接受 ISO 日期/日期时间（`2026-01-01`）或相对简写（`90d`、`4w`、`6m`、`2y`）。筛选 `published_at`；没有日期的版本将被舍弃。仅影响版本发布部分——非常适合“过去 90 天内谁添加了 X”等能力发现查询。
until	string	否	仅保留在此界限当天或之前发布的版本结果。输入格式与 `since` 相同；仅指定日期（`2026-06-25`）时，会包含该 UTC 日期的全天。
domain	string	否	限定为拥有此域名的组织。输入会规范化（去除 scheme/path/www，并转为小写），因此 `https://vercel.com/` 和 `vercel.com` 都有效。如果该域名不属于任何已索引对象，则返回“无匹配”消息。如果输入为 URL 格式，请使用此参数而不是 `organization`。
entity	string	否	将版本发布结果限定到一个目录条目。接受 prod_ ID（展开为该产品下的所有来源）、src_ ID，或格式为 orgSlug/slug 的组织范围坐标（例如 'vercel/nextjs'）。不接受没有组织前缀的裸 slug。
product	string	否	将发布结果限定为特定产品的来源。接受 prod_ ID 或格式为 orgSlug/productSlug 的组织范围坐标（例如 'vercel/next-js'）。不接受不带组织前缀的裸 slug。如果同时提供 `entity` 和 `product`，则优先使用 `entity`。解析出的产品坐标会回显在 `_meta.search.product` 中。
organization	string	否	将发布结果限定为属于此组织的来源。接受 org_ ID、slug 或已注册域名。
include_empty	boolean	否	在 `orgs` 部分中包含索引发布数为零的组织。默认值为 false——空组织只是占位项，会产生噪声。按 `domain` 限定范围时会忽略此项，并始终返回解析出的组织。
include_coverage	boolean	否	包含被归类为另一个发布的覆盖内容的发布（例如，重新宣布平台发布的营销帖子）。默认值为 false，因此每项底层发布只出现一次。

详细介绍

发布说明索引

为 Agent 编入索引的最新产品发布信息。

汇集全网发布说明的注册表——从厂商变更日志中抓取内容，统一为一种模式，生成摘要，并可通过终端、代码或任何 MCP 客户端查询。你和你的 Agent 都能轻松阅读。

releases.sh · 文档 · CLI → · 使用方法 · 此仓库的内容 · 参与开发

_{此仓库是 releases.sh 的后端（API · MCP · Web · 数据采集）
以及命令行工具的源代码。}

这是什么？

“有什么变化？”是 Agent 和开发者经常会问的问题——升级之前、事故之后，或工具突然表现异常时。答案散落在 GitHub 发布页、RSS 订阅、变更日志页面和博客文章中，格式各不相同。

发布说明索引将这些信息汇集到一个注册表中。它持续监控开发者实际依赖的数百个厂商的信息源，并为每次发布保存原始内容，以及 AI 生成的标题、摘要和破坏性变更分类。每个组织都会获得一份持续维护的近期发布概览。人类阅读的网页与 Agent 获取的 JSON 内容一致。

此仓库是 releases.sh 官方部署的源代码：API 工作器（权威数据平面）、MCP 服务、Web 前端，以及负责保持注册表信息最新的数据采集流水线和 Agent 工具框架。面向用户的 CLI 位于 apps/cli/，并从此仓库发布（npm + Homebrew）。

使用方法

读取无需账号或 API 密钥——四种访问方式均公开。

MCP — 部署于 agents.releases.sh/mcp（mcp.releases.sh/mcp 仍可使用），已列入 MCP Registry （名称为 sh.releases/mcp），也已列入 Claude connector directory，可供网页版、桌面版和移动版 Claude 使用：

claude mcp add --transport http releases https://agents.releases.sh/mcp   # Claude Code
codex mcp add releases --url https://agents.releases.sh/mcp               # Codex
npx -y mcp-remote https://agents.releases.sh/mcp                          # stdio bridge (VS Code, Zed, …)

CLI — 可通过 npx 一次性使用，也可运行 brew install buildinternet/tap/releases 安装：

npx @buildinternet/releases get anthropic     # what did Anthropic ship lately?
npx @buildinternet/releases search "MCP"      # search across every vendor

REST API — api.releases.sh 上的公开 GET 端点，规范见 /v1/openapi.json：

curl "https://api.releases.sh/v1/releases/latest?limit=5"

Agent 技能 — 可自动触发的操作手册，可安装到任意 Agent（Claude Code / Codex / Cursor / OpenCode）中，无需检出任何内容。建议从读取类技能开始——搜索、MCP 查询和版本发布分析，这些是绝大多数用户需要的功能：

npx skills add buildinternet/releases   # reader skills — search, MCP, release analysis

# just the skill that writes a releases.json manifest for your own product
npx skills add buildinternet/releases --skill creating-releases-json

在 Claude Code 上，CLI 仓库也可以作为插件安装——包含读取类技能、捆绑的 MCP 连接，以及 /releases 命令：

/plugin marketplace add buildinternet/releases
/plugin install releases@releases

_{正在运行或维护注册表本身？此仓库还提供运维技能（来源接入、解析、批量维护）——大多数技能需要管理员密钥：npx skills add buildinternet/releases。请参阅
releases.sh/docs/skills。}

文档 — 面向用户的文档由 Web 应用提供，地址为 releases.sh/docs（源文件位于 apps/web/src/content/docs/）：安装 · 技能 · REST API · MCP · webhook · 列出你的产品。

使用该产品的 Agent 可从 releases.sh/llms.txt 开始；MCP 工具目录和身份验证模式也见于 docs/architecture/mcp.md。创建免费账号可提高速率限制（在 releases.sh/account 创建 API 密钥），还可使用关注、个性化信息流、webhook 和电子邮件摘要。

组织页面：由 AI 维护的近期版本发布概览、来源列表，以及 JSON/Markdown/Atom 导出

_{每个组织页面都包含由 AI 维护的概览，并支持导出为 JSON、Markdown 或 Atom。}

此仓库包含什么

路径	内容
`apps/api/`	基于 Cloudflare D1 的 Hono API——权威数据平面
`apps/mcp/`	部署于 `agents.releases.sh` 的远程 MCP 服务（别名为 `mcp.releases.sh`）
`apps/webhooks/`	对 `release.created` 事件进行签名并发送（HMAC-SHA256，重试/DLQ）——文档
`apps/web/`	Next.js 前端，部署于 Vercel
`packages/`	共享代码——`core` 和 `api-types` 发布到 npm；其余为私有工作区
`.claude/`	Claude Code 配置——`skills/`（规范技能目录）、`agents/`、`commands/`、`workflows/`

组件协作方式：

存储 — Cloudflare D1（FTS5 + Vectorize）。API worker 是唯一的数据平面。
摄取 — 用于 GitHub Releases、RSS/Atom/JSON 信息流的适配器，以及适用于不提供信息流页面的浏览器渲染回退方案（packages/adapters/）。爬虫会以 Cloudflare Verified Bot 的身份，使用 RFC 9421 对出站请求进行签名。
AI — 变更日志解析、摘要生成、分组和组织概览均在 API worker 中通过直接调用 Anthropic SDK 运行。

贡献者心智模型

此仓库包含四类代码：

区域	路径	需要了解的内容
产品界面	`apps/api/`、`apps/mcp/`、`apps/webhooks/`、`apps/web/`	API Worker 是数据平面。Web、MCP、CLI 和 Webhook 从中读取数据或通过它路由请求。
共享包	`packages/core/`、`packages/api-types/`、私有 `packages/*`	`core` 负责架构和纯辅助函数；`api-types` 负责线上的数据结构。共享契约变更时，先修改这些包。
托管运营	`.claude/skills/`、`.claude/workflows/`	这些内容支持规范的 releases.sh 摄取流程和运维循环。部分路径需要托管凭据，但本地工作不需要。
历史背景	`docs/architecture/`、`docs/plans/`、`docs/superpowers/`	架构文档是持续维护的参考资料。计划和规格说明记录的是特定时间点的设计历史。

一般贡献流程从 bun run bootstrap、bun run check 和 bun run test 开始。处理核心循环不需要生产环境的 Cloudflare、Anthropic、Vercel、电子邮件或 Firecrawl 访问权限。如果你要 Fork 或自托管完整服务，请阅读 deploy-coupling.md。

各包的详细说明和项目约定见 AGENTS.md——这是在此仓库中开展工作的 Agent 入口。架构深入解析见 docs/architecture/，并可从 docs/README.md 的阅读指南开始。

本地开发

前置条件： Bun。核心循环无需外部账号：

bun run bootstrap        # one-command setup: tooling, deps, env files, local D1
bun run doctor           # diagnose the setup — reports what's missing and how to fix it

bun run check            # lint + type-check + format (the CI gate)
bun run test             # full test suite, secret-free
bun run dev:api          # API worker on local D1
bun run dev:web          # Next.js frontend

bootstrap 是幂等的（可安全重复运行；不会覆盖你的环境文件或清除本地数据库），而 doctor 仅执行读取操作。更喜欢手动步骤？运行 bun install，复制每个 *.example 环境文件，然后运行 bun run db:reset:local。

AI 处理、抓取请求和语义搜索需要使用你自己的密钥（ANTHROPIC_API_KEY、Cloudflare Browser Rendering、VOYAGE_API_KEY）；没有这些密钥时，功能会优雅降级。设置详情、环境变量、测试、部署以及无需账号／自带密钥／仅托管的完整说明见 CONTRIBUTING.md。