已上线 · Phase 1

AI Agent 时代而生的 Changelog

Pulse 让 Claude / Cursor / GPT 真正能"读懂"你的产品演进。每个项目都自带原生 MCP 服务、签名化 feed 和 Agent Token —— Agent 在一次握手里就拿到所有需要的信息。

为什么 AI 需要专门的 Changelog

Agent 不再只是偶尔查文档的工具人

在 2026 年,AI Agent 已经会主动帮用户回答"X 产品最近有什么变化吗?",它们会调用工具、写代码、改配置。如果你的 Changelog 不能被机器理解,Agent 就会给出过时的答案。

Pulse 把 Changelog 重新设计成 机器可消费的协议层,而不是单纯的网页。每一份发布都带语义化的 kindbreakingtags,每一段 feed 都用项目持有的 Ed25519 密钥签名 —— Agent 可以独立验证、缓存、订阅。

AI 端点

1. 三套为 AI 设计的入口

同一个项目,针对不同消费方提供三种入口。

/a

agent.md

给 Agent 的入门说明:用最少 token 告诉对方"我是谁、有什么端点、怎么调用"。

# Auto-generated by Pulse name: acme mcp: /api/public/projects/acme/mcp tools: 6
L

llms.txt / llms-full.txt

遵守 llmstxt.org 约定 —— LLM 在启动时会主动拉取,是 SEO for AI 的事实标准。

# llms.txt > Acme Cloud changelog ## Docs - [feed](/pulse/feed.json)
/f

/for-agents

人类友好的索引页:列出所有 AI 入口,给出"我是 Claude,我该用什么"的提示。

# /for-agents → Add this site to Claude / Cursor → MCP URL: .../mcp
MCP · JSON-RPC 2.0

2. 原生 Model Context Protocol 端点

Pulse 在每个项目根目录都暴露一个标准的 MCP 端点,遵守 modelcontextprotocol.io 规范。Claude Desktop / Cursor / Windsurf / Cody 可以直接接入。

POST /api/public/projects/acme/mcp
// 1. initialize{ "protocolVersion": "2024-11-05", "capabilities": {"tools": {} } } // 2. tools/list{ "tools": [pulse_get_well_known, pulse_get_feed, pulse_get_entry, pulse_search, pulse_get_trust, pulse_get_stream] } // 3. tools/call — pulse_search{ "q": "webhook retry", "limit": 5 }{ "hits": [ { "entry_id": "c_abc123", "title": "Webhook retries", "score": 0.87 } ] }
pulse_get_well_known

自描述发现文档 —— 公钥、协议版本、所有端点 URL。

pulse_get_feed

签名化 feed。参数:limitbreaking

pulse_get_entry

entry_id 取单条 SignedChange。

pulse_search

TF-IDF 关键词搜索。参数:qlimit

pulse_get_trust

返回 Trust Score(A/B/C/F)和 5 个维度的分项评分。

pulse_get_stream

返回 SSE 元信息(事件列表)。客户端应直连 /pulse/stream

🔒 所有 pulse_* 工具都是只读的 —— Agent 永远不能通过协议层发布内容,发布必须由 owner 在控制台完成。

认证

3. Agent Token — 独立速率桶 + 项目作用域

为 AI Agent 准备的专用凭证,附带更高的速率配额和可选的项目隔离,方便对外安全分发。

创建 Agent Token

owner 在控制台生成,可选限定到某个项目:

POST /api/account/api-tokens
{ "name": "My Claude agent", "scope": "agent", "project_id": "p_abc123" }

使用 Agent Token

请求头携带 Authorization: Bearer pulse_agent_xyz

curl
$ curl -H "Authorization: Bearer pulse_agent_xyz" \ https://acme.pulse.dev/api/public/projects/acme/mcp scope: AGENT limit: 300 req / 5 min / token

双层速率限制

USER · 30 req / 5 min / IP

浏览器登录用户使用。

AGENT · 300 req / 5 min / token

对外分发的 Agent 凭证。

匿名 · 30 req / 5 min / IP

公共读取,防滥用。

未来规划:引入 sliding window(4 windows / 60s) + 每个项目的速率策略。

实时

5. SSE 实时流 — Agent 可以订阅变更

通过 Server-Sent Events 实时推送发布事件,Agent 可以构建"实时播报"或"自动代码生成"工作流。

GET /pulse/stream
event: ready data: {"project":"acme","ts":1723875825} event: entry.published data: { "entry_id": "c_8hk2", "title": "Webhook retries", "kind": "improvement", "breaking": false } event: key.rotated data: {"new_key_id":"k_2026_09"}
信任

6. Trust Score — 给 Agent 一个评级依据

Pulse 自动计算每个项目的 Trust Score(A/B/C/F 等级),让 Agent 知道哪些项目"值得长期跟踪"。

5 个评分维度

  • 发布频率(活跃度)
  • 版本稳定性(breaking 占比)
  • 通信质量(feed / agent.md 完整性)
  • 加密签名启用情况
  • 外部依赖 / Federation 行为
A · 90+ B · 75-89 C · 60-74 F · <60
GET /pulse/trust.json
{ "grade": "A", "score": 92, "components": { "activity": 95, "stability": 88, "signing": 100 } } // 全局排行榜(≥ 3 releases) GET /api/public/leaderboard?limit=20
编辑器接入

7. 在你的 IDE / Agent 工具里启用 Pulse

接入 Pulse 只需要告诉 Agent 一个 URL。

Claude Desktop

在 MCP 配置里加上 pulse://acme —— Pulse 会自动拉取发现文档与公钥。

Cursor / Windsurf

通过 /mcp 端点接入。Agent 启动时自动发现 6 个 pulse_* 工具。

官方插件 · 未来规划

VS Code + Continue

配置 OpenAI-compatible MCP server,URL 指向 /mcp

Claude Code / Aider

通过 CLI 调用 pulse search / pulse watch 把结果注入对话上下文。

自定义 Agent

任何 HTTP 客户端:用 Agent Token 调用 /mcp,纯 JSON-RPC。

Python / Go / Rust

使用 fetch(<url>) + 任何 Ed25519 库在 50 行内实现完整验证。

多语言 SDK · 未来规划
未来规划

AI 能力的下一步

Phase 1 已经让 Agent 能"读懂"你的 Changelog,下一步我们要让 Agent 能"主动参与"。

AgentUsageEvent 深度分析

记录每个 Agent Token 调用了哪些工具、花了多少 token、是否出错。让 owner 能看到"我的 Claude 都在调什么"。

未来规划

MCP Streamable HTTP transport

替代 SSE 的新一代 MCP 传输协议(解决 SSE 的连接限制与代理问题)。

未来规划

Cursor / Windsurf / Cody 官方插件

让用户在 IDE 设置里一键启用 Pulse MCP,而不是手动填 URL。

未来规划

Vector index 升级

当项目超过 1k 条 entries 时,把 PulseSearchService 内部换成向量索引,HTTP 端点保持不变。

未来规划

Per-tool 速率策略

不同工具不同配额:搜索可以放开,trust 可以收紧。

未来规划

AI 自动生成 digest

调用 LLM 把一周的发布总结成一段给 owner 的周报邮件。

未来规划

让 AI Agent 真正成为你产品的使用者

Pulse 不是 ChatGPT 时代的 Changelog,是 Agent 时代的 Changelog。