# Pulse Relay

> 让网站把一件事（订单、上传、构建、会议……）显示在用户 iPhone 的灵动岛和锁屏上，并在 App 不在前台时实时更新。网站不需要苹果开发者账号或 APNs 密钥：做一个页面和三个接口，状态变化时向 Pulse Relay 推送中转发一个签名的 HTTPS 请求。

## 文档

- [网站接入 API（完整，Markdown）](/pulse-relay-api.md)；网页版在 [/docs/](/docs/)：三个接口、推送签名、四种模板（状态 / 进度 / 步骤 / 倒计时）、返回码、频率限制、Node / Python / curl 示例。

## 要点

- 推送中转：https://relay.crsyounen.com （旧地址 https://pulse-relay.crsyounen.workers.dev 是同一个中转，大陆无法访问），接口 `POST /v1/devices/{deviceId}/push`。
- 认证：请求头 `X-Pulse-Source: {sourceId}` 和 `X-Pulse-Auth: v2 <unix秒> <requestId> <base64url(HMAC-SHA256(pushKey, "POST\n路径\nunix秒\nrequestId\nsha256hex(请求体)"))>`。
- 连接：App 在系统安全登录窗口里打开网站的 `authorize` 页面（钥匙 deviceId、sourceId、pushKey 在网址 `#` 后面）；用户登录并点「允许」后，页面用同源 `fetch` 调网站的 `POST {connect}`（带 `X-Pulse-Relay: 1`）保存，再跳回 `pulserelay://site-connected?state=…&status=ok`。收到 401 / 403 / 410 时删除钥匙。
- 同一 `ref` 一个实时活动；`revision` 严格递增；`start` 每小时每台手机最多 4 次。

## 可选

- [演示](/demo/)：用 App 连接本站后，点按钮把四种模板推到自己的灵动岛。
- [Mac 电脑端下载](https://github.com/crsyounen/pulse-relay-mac/releases/download/v0.1/PulseRelay-Mac.dmg)：让 Mac 上的 Claude Code / Codex 会话显示在灵动岛上。