项目事件 API

按序列升序列出持久项目事件。

分页是连续的：将返回的 next_cursor 作为 after 传递，精确续接页面停止处。next_cursor 是最后返回事件的游标，当有更新事件存在时，历史末尾为 null。limit 默认为 50，接受 1-200；超出范围的值返回 invalid_request 和包含 limit 的 errors[]。

不支持偏移分页。source=log 列出播放器日志：按接收时间升序报告播放器发送的条件（runtime.reported），通过 screen_id 和严重级别过滤，时间窗口从至（默认最近 24 小时，最多 31 天）。

其游标不透明：lg1_ 或 ev1_，取决于服务器存储播放器日志的位置，故返回页面的游标应传回；其他类型游标拒绝，返回 invalid_request 并指明字段。播放器日志记录无序列，不在 GET /stream/project 上，也不传递给 webhook。

当播放器日志队列接受记录时，该记录被确认，并保留用于项目的事件保留。使用最后的游标和默认窗口进行轮询，跟踪日志。播放器日志记录不在默认（source=project）列表中。除非 source 是 log，否则 from 和 to 会被拒绝并返回 invalid_request。

项目列表使用 screen_id、playlist_id 和 application_id 读取一个屏幕、播放列表或应用程序的事件，所有事件均限定为凭证的项目（一个 ID 指定读取哪些事件，永不指定谁的）：screen_id 保留资源为该屏幕的事件；playlist_id 保留资源为该播放列表的事件加上将其命名为 details.playlist_id（使用该播放列表的屏幕）的事件；application_id 保留资源为该应用程序的事件加上资源带有其为 application_id（其发布和键值条目）的事件。

非其类型 ID 的值被拒绝，返回 invalid_request 并指明字段；playlist_id 和 application_id 在 source=log 时被拒绝，日志记录仅属于屏幕。

两个来源都接受resource_id、类型和严重性（至少），彼此组合，并与 id 筛选和分页结合；播放器日志记录是runtime.reported记录，其资源为其屏幕，因此resource_id不是该屏幕或类型排除runtime.reported时，返回空页面。before（或 order=desc）分页为最新优先：next_cursor为返回结果中最旧项的游标，作为 before 继续查找更早的项。

无起始时间时，最新优先的 source=log 页面会超出默认的 24 小时，直到项目事件保留的最旧记录，每次请求最多 31 天。最新优先的 source=log 页面可能包含少于限制数的记录，甚至无记录，但带有 next_cursor；null 表示结束，位于保留日志末尾。

限定屏幕范围的调用方（docs/screen-scope.md）读取经过筛选的事件流：范围内屏幕的事件，其可见屏幕文件夹（自己的文件夹，以及上级和内部的文件夹；screen.moved 仅在目的地位于其范围内时）的事件，活动、播放列表、媒体、应用和卡片的事件，以及 playlist_change 审核。

其他所有事件都会被省略，因此一页可能少于 limit 个事件，甚至为空，但仍带有 next_cursor；请继续用它翻页。source=log 需要其范围内的 screen_id。不发送关于项目本身的事件。

可重放的项目监听流。播放器日志记录（runtime.reported）通过 GET /api/events?source=log 读取，不在此流上。打开此请求会作为监听订阅消耗 1 个额度。额度响应头已省略。之后计费的事件每个消耗 1 个额度；screen.*、runtime.*、alert_mute.* 和 application.event 不计费。

心跳和重试前言不计费。stream.cursor 和 stream.resync_required 计费。借记幂等性为 sse-event:<project_id>:<sequence>，因此重新连接重放免费。未支付的计费事件不会写入，且流关闭。

用控制台会话打开的流不计费（打开及其事件都不计），与控制台的 API 请求一样；它仍占用项目的一个流名额。限定屏幕范围的调用方（docs/screen-scope.md）会收到与 GET /api/events 相同的筛选事件流：被丢弃的事件不发送帧，stream.cursor 继续推进位置。

范围在流打开时读取，文件夹树在移动或文件夹事件时再次读取；收窄的范围在已打开的流重新连接时生效。