直播事件参考

查找源的事件名称、负载字段和捕获要求。有关支持的警报的快速概述，请参阅事件和提醒兼容性.

捕获设置、过滤器和负载约定

重要： 事件是否可用取决于来源、权限和捕获设置。要在停靠面板或精选叠加层中隐藏带事件标记的行，请添加 &hideevents 或 &hideallevents。要隐藏所选事件，请使用 &filterevents=subscription_gift,new_follower,gifted。这些筛选器也可以隐藏带有以下标记的付费行： event；没有事件标记的普通打赏行不会被事件筛选器匹配。其他消息筛选器仍然适用。

选择捕获方法： 对于 YouTube、Twitch 和 Kick， WebSocket 模式 通常提供更广泛的事件覆盖。标准 DOM 捕获读取页面上实际渲染的行和卡片。YouTube Super Chats、Super Stickers 和 Jewel 礼物在两种模式中都有捕获路径；其他礼物、打赏和会员事件因来源而异。受支持的路径和必要设置请参阅平台表格。

正在构建自动化？ 请查看 Event Flow 指南了解如何在自定义触发器、提醒和工作流中使用这些事件载荷。该指南包含模板变量参考了解文本格式。礼物金额、连送计数和可编辑游戏示例请参阅制作游戏与奖励.

载荷结构： 打赏样式的聊天行应使用 hasDonation 和可选的 donoValue。不要设置 event: "donation" 仅仅因为普通聊天/打赏行有金额；仅对真实平台操作或付费商品类型使用具体事件名称，例如 superchat, supersticker, gift，或 jeweldonation。使用 meta 仅用于使用方确实需要、且现有字段尚未涵盖的额外结构化数据。

功能可用性速览

使用此表查看每种捕获方式目前提供哪些提醒类型。详细载荷说明见下文。

专用的 Multi-Stream Alert Box 将直播事件分为六个核心提醒类别： Follow, Subscription/Member, Donation, Bits/Cheers, Raid/Host，以及 Purchase，以及两个需主动启用的类别（Auction 和 Hype Train）通过 URL 参数启用。这些类别根据现有的 event, membership, subtitle, hasDonation，以及 meta 此处记录的字段；无需单独的载荷格式。

来源	新订阅者 / 会员	新关注者	打赏	计数和其他数据
YouTube（Data API 桥接）	会员加入、续订、赠送	单个订阅者提醒*及总数	Super Chats & Super Stickers	观众、订阅者和观看总数（轮询）
Twitch — DOM 捕获	赠礼包行和获赠通知	-	Bits 通过以下字段标记： `hasDonation`	观众数量、奖励卡片和社区高亮卡片
Twitch — EventSub/Websocket	即时订阅、续订和赠送	即时关注及关注者总数	Cheers、Power-ups 和频道积分兑换	观众/订阅者/关注者总数、直播状态、广告通知
TikTok Live	-	关注卡片（TikTok 显示时）	礼物转换为金币总数	观众数量、加入提醒和点赞风暴
YouNow	-	粉丝和观众活动	-	来自直播观众面板的观众数量
Favorited Studio	-	-	-	来自直播观众标签页的观众数量
Whatnot	-	-	-	观众数量、加入提醒、直播拍卖元数据、商品和赠品抽奖快照
eBay Live	-	-	-	观众数量、关注者数量、直播事件卡片快照、拍卖页脚元数据（提供时）、爱心回应和即将举行活动的元数据
Streamlabs 提醒框	订阅、礼物、赞助、关注	Cheer/bits、打赏（带货币）	Cheer/bits、打赏（hasDonation）	提醒框打开时；也可通过以下方式使用： `sources/websocket/streamlabs.html` socket 令牌
OBS Flow Actions	-	-	-	用于 Event Flow 的 OBS 输出、场景、回放缓冲区和媒体结束事件，在以下情况下： `actions.html` 已连接到 OBS WebSocket
Kick — DOM	-	-	-	观众数量及基本奖励/礼物系统通知；如需更丰富的提醒，请使用 Kick 桥接
Kick — Websocket/桥接	新订阅、续订和赠送	关注提醒 + 关注者总数	支持/打赏事件（金额 + 货币）	直播状态、奖励兑换和个人资料元数据
Facebook Live	-	-	DOM 中可见时的 Stars	聊天行、Stars 和观众数轮询
Rumble — DOM 捕获	-	-	可见的 Rant 价格	聊天、入站 raid 和观众数轮询
Rumble — Websocket/API URL	新订阅和赠送订阅	关注提醒 + 关注者总数	Rant/打赏（金额 + 货币）	观众总数、订阅者总数、直播状态和聊天信息流
Streamplace	-	-	-	观众数量及聊天姓名、颜色、徽章、回复和链接
WorldsWave	-	-	存在时的打赏标签	渲染的直播聊天及可选启用的观众数量更新
CHZZK	-	-	可见的奶酪打赏行	聊天行、徽章图片、表情和观众数轮询
BEAM	-	-	-	聊天行；仅聊天页面提供观众计数器时，还包括观众数轮询
Seal Team Sloth	-	-	-	渲染的弹出聊天行及 `viewer_update` 启用观众数量时进行轮询
Castyr	-	-	-	渲染的弹出聊天行及可选启用的观众数量更新
RPLAY	-	-	-	已登录 `/live/chat/box/` 弹出窗口： `type: "rplay"` 聊天、头像、等级徽章图像和表情。金币打赏在以下字段中保留金额/单位： `hasDonation` 用于共享美元换算，不带打赏事件。可选启用的 `viewer_update` 轮询使用整数 `meta` 来自 RPLAY 的公开直播端点。排除转发的 Twitch 行。
FLEX TV	-	-	-	渲染的聊天行，包含姓名、作者颜色、徽章图像和会员元数据
好游戏	-	-	-	聊天、观看者计数和本机聊天消息 ID（如果可用）
起球	-	-	-	聊天和查看者依赖于专用聊天和主题页面
Owncast	-	-	-	来自 Owncast 服务器的聊天和观看者计数
皮卡托	-	-	-	公共聊天弹出窗口中的聊天和查看者计数
皮策尔	-	-	-	聊天和观看页面上的聊天捕获和观看者计数

*YouTube 订阅者提醒通过轮询获取，可能延迟或不完整。API 参考并未承诺固定的四小时交付窗口。请参阅官方订阅 API 限制.

字段概览

data 此处指消息对象，不是需要添加的额外包装层。聊天行和仅元数据事件具有不同结构：计数器和状态快照可能省略 chatname/chatmessage。在平台表格中，消息描述普通聊天行，而非字面上的 event: "message".

字段	结构	用法
`data.type`	字符串	叠加层、筛选器和 Event Flow 使用的来源标识符。Instagram 将直播聊天保留为 `instagramlive` 以及将非直播评论表示为 `instagram`。请参阅来源类型指南用于变体、通用来源和出站路由。
`data.chatname`	字符串	消息处理和非覆盖输出使用的源提供的显示名称。配置的用户显示名称别名只能在复制的停靠和覆盖传输有效负载中替换该值。选择加入显示显示名称（用户名）当来源提供两个名称且它们不同时，设置会附加用户名，忽略大写，例如 `알렌 (allenhklee)`。这些副本保留源名称 `meta.sourceDisplayName` 用于适度匹配。自定义别名优先； `username` 仍然是帐户登录。
`data.username`	字符串	可用时的来源用户名。应用别名的停靠面板或叠加层载荷可能添加此字段以保留原始的 `chatname` 用于用户操作；规范消息保持不变。
`data.userid`	字符串	平台专属的用户标识符。用户操作优先使用此值，而非 `username` 和 `chatname`.
`data.platform`	字符串（可选）	一些集成会将此字段与以下内容一起包含： `type`。很多来源适配器会省略它；请使用 `type` 用于来源路由。
`data.id`	字符串 \| 数值（可选）	消息或事件标识符。其含义取决于来源和传输方式；不要假定它始终是平台原生的管理 ID。使用 `meta.messageId` 当适配器为删除同步提供它时。
`data.donoValue`	数值（可选）	来源提供的数值型等值美元金额，包括估算值。有效值（包括零）会覆盖 currency.js 换算。没有此值时，使用方根据 hasDonation 和来源上下文估算美元金额。原始金额和单位保留在 hasDonation 及现有的提供商元数据中。
`data.chatbadges`	数组 \| 字符串（可选）	徽章图片 URL 或徽章对象（`type: "img"` 带有 `src`, `type: "svg"` 带有 `html`，或 `type: "text"` 带有 `text`）。转发会将文本徽章的原始标签保留在可选的 `rawText` 并生成经过转义的 `text` 用于旧版叠加层。后续转发时，重新生成 `text` 来自 `rawText`；不要转义 `text` 再次。当前渲染器显示 `rawText` 存在时按字面处理，否则保留旧版编码文本处理。这是表示形式字段，不是渲染 HTML 的许可。旧版来源可以发送单个 HTML 字符串而非数组。渲染徽章的叠加层接受两种格式，并在本地净化徽章 HTML 和 URL，包括发送方为旧版扩展时。无效徽章不得阻止聊天或会员消息显示。
`data.event`	字符串 \| 布尔值	系统活动标识符（例如 `viewer_update`, `subscription_gift`, `giftpurchase`）。普通聊天应将其留空或设为 false，以便叠加层区分系统通知与对话文本。
`data.chatmessage`	字符串	消息正文。仅在以下条件满足时可包含经过净化/可渲染的 HTML： `data.textonly` 为 false。
`data.textonly`	布尔值	仅适用于 `data.chatmessage`. `true` 表示渲染 `chatmessage` 作为纯文本，保留字面标签和看似实体的文本；不要解码、进行 HTML 净化或向该正文添加格式标签。将事件样式应用于显示元素。 `false` 表示 `chatmessage` 可以包含经过净化/可渲染的 HTML；不含该标志的旧消息保留此 HTML 行为。其他普通字段为纯文本，以下媒体字段除外： `chatimg` 和 `contentimg`。使用以下方式显示纯文本字段： `textContent`，或在构建 HTML 模板时转义一次；不要删除或反复解码其内容。
`data.contentimg`	字符串（可选）	内容图片或支持的媒体 URL。在扩展和桌面应用中，需主动启用的 `allowExternalGifs` 设置会使用消息文本或 HTML 链接中的第一个直接 HTTP(S) GIF 链接填充空字段。URL 路径必须以以下内容结尾： `.gif` （不区分大小写）；保留查询参数和片段。不需要 API 密钥，并保留 `chatmessage` 和现有附件，并遵循 `removeContentImage`。可选的 `hideExternalGifUrl` 设置添加 `meta.hideExternalGifUrl: true`；停靠面板和精选叠加层仅在图片加载后隐藏对应的 GIF 链接，同时保留周围文本和原始载荷。图片失败或超时会折叠其附件容器，并保留链接可见。仅 GIF 的叠加层在获取图片字节失败时尝试直接显示图片，并在无法获取动画时长时使用已配置的显示时间；失败或停滞的加载会推进队列。它不会添加 `event` 或更改来源 `type`。外部图片不经过内容过滤；如果托管方阻止嵌入，可能无法加载。
`data.membership`	字符串	可读的会员状态，例如 `MEMBERSHIP`, `new_sponsor`, `gift_recipient`。各界面将其用于徽章、筛选器和公告。
`data.subtitle`	字符串	补充描述（会员时长、等级升级、赠送者等）。保持简短并使用纯文本，方便叠加层将其放在显示名称下方。
`data.hasDonation`	字符串	货币或虚拟礼物金额（`$5.00`, `500 bits`, `300 coins`）。即使在以下情况下也要填写： `data.event` 为空，以便打赏叠加层可以检测到它。
`data.meta`	数值 \| 对象 \| 字符串（旧版）	单一计数器（观众、关注者、订阅者）使用纯整数，更丰富的上下文使用对象。一些较旧的事件，例如 Twitch DOM `community_highlight`，携带字符串。在读取对象属性前检查特定事件的数据结构；新增的结构化详情应放在对象中。
`data.firsttime`	布尔值	设为 `true` 当首次聊天者检测和本地数据库都已启用，且这是该用户/来源的第一条已存储聊天消息时。停靠面板用它进行首次聊天高亮和首次聊天提示音筛选；可选的首次聊天徽章设置会在以下字段前添加叶子徽章： `chatbadges`.
`data.lastactivity`	数值	启用首次聊天者检测和本地数据库时，该用户上一次已存储聊天活动的 Unix 时间戳（秒）。全新用户省略此字段。

Meta 约定

叠加层控制传输与捕获的聊天/事件分开。更新后的接收端使用 ssnControl 封装，其中包含交付 id，展示 target、可选的回复频道和快照客户端 ID。现有功能请求体保持完整。公开功能控制使用频道 7；Actions 保留频道 6。Poll 和 Map 状态包含主播的 epoch, revision 和 reset 标记；Timer、Ticker 和 Spotify 使用 ssnState 带有 epoch 和 revision。这些标记描述主持人状态，并非恢复的投票/聊天历史。来源不得向捕获的消息添加控制封装字段。接收确认不代表操作完成或 OBS 可见。请参阅迁移状态了解受支持的功能、回复协商和重连限制。

Phrase Guess 使用原生的 {response: text} 请求，用于 server2 聊天回复，以及 {action: "phraseGuessResponse", value: {type: "bot", chatname: name, chatmessage: text}} 用于仅停靠面板公告。主持人必须启用传入的 server3 消息；禁用主持人控制仍会阻止这些请求。停靠面板公告会作为普通机器人聊天行转发，带有 textonly: true，而不会将它们发送到捕获来源的聊天输入框。旧版 API 模式保留现有命令格式。

为了保持仪表板和自动化一致，扩展以下内容时请遵循这些约定： data.meta:

viewer_update, follower_update, subscriber_update，以及 likes_update 使用纯整数 meta 值。 likes_update 是权威的平台总数：使用方必须直接设置显示值，而不是将其累加。后台脚本将观众数量汇总到 viewer_updates 带有以以下字段为键的对象： data.type.
giveaway_state 是由主持人生成、用于受管理显示的仅元数据快照。 meta.giveaway 第 2 版包含 giveawayId，持久的 roundId/epoch，递增的 generation 跨新轮次， revision 在一个轮次内， status, open, draw, keyword, count, ticketCount，冻结的 config，最多 120 个预览 entrants，以及最近的 20 条 winners。条目公开 id, name, platform 和 tickets；获胜者添加 drawnAt 以及授予的 points。Coin Flip Pot 添加 outcome；Number Hunt 添加 number 带有公开的 low, high 和最近的 guesses，绝不包含密钥。使用方按抽奖 ID 筛选并丢弃较旧的 generation/revision。这些是显示样本，不是完整票据账本或付款指令。钱包密钥、余额和预留信息不会出现在面向观众的快照中。主播发布到 giveaway P2P 标签和已启用的叠加层 WebSocket 信息流；这并不表示 OBS 可见。指南.
meta.giveawayControlResult 包含 Event Flow 赠品抽奖操作的结果（ok，可选的 error, giveaway 或 simulated). meta.giveawayHandled 列出已由参与/购买流程操作处理的赠品抽奖 ID，以免自动聊天命令再次扣费。编辑器添加 meta.economyTest 用于模拟赠品抽奖操作；它不是来源平台事件，也不是授权凭据。
video_stats 使用结构化的 meta 对象，用于外部编码器/服务器运行状况，包括 provider, label, online, bitrateKbps, rttMs, bufferMs、丢包/丢弃计数器，以及可选的编解码器详情。
打赏样式的事件可包含描述性对象，例如 { amount, currency, supporter } 用于 Kick， { bits } 用于 Twitch cheer。会员事件有自己的来源专属元数据；它们不会自动算作货币打赏。
标准化的 Stripe、Ko-fi、Buy Me a Coffee 和 Fourthwall webhook 消息包含按提供商划定范围的 meta.webhookId，从提供商的稳定事件标识符复制，以便下游页面抑制重试和混合传输导致的重复事件。
Twitch 突袭传递 { fromId, fromLogin, viewers }。其他来源不同：Whatnot 使用 meta.numRaiders，SharePlay 则使用可选的 meta.fromLogin/meta.viewers。读取 raid 元数据前请检查特定来源对应的行。
Twitch EventSub 奖励兑换提供 meta.rewardId, cost, rewardTitle, redemptionId，以及旧版的 alias 与准备好的消息一起提供。DOM 奖励卡片和其他来源可能提供更少或不同的字段。
user_banned 仅含元数据，供管理组件使用。它有意省略 chatname 和 chatmessage；使用 meta.username, meta.displayName, meta.avatarUrl，以及 meta.profileUrl.
支持来源控制删除同步的聊天传输，应将平台原生聊天标识符公开为 meta.messageId 而不是依赖停靠面板内部的 data-mid 值。
来源删除使用 {delete: {type, id}} 用于已知的停靠面板消息 ID，或 {delete: {type, meta: {messageId}}} 用于原生平台消息 ID。已知 ID 只移除匹配的消息。仅知道目标用户时，发送 {delete: {type, userid}} 或 {delete: {type, chatname}} 以从该平台移除该用户的消息。绝不以版主身份替代目标用户。传入的删除不需要启用可选的停靠面板到平台管理同步设置。
SSApp 来源身份元数据可能添加 meta.ssnAccountRole, meta.ssnSourceId，以及 meta.ssnSession 当来源被分配非普通账号角色时。
Event Flow 可通过设置以下字段请求高亮： meta.featured = true 位于聊天载荷上，会在停靠面板/featured 叠加层中自动精选该消息。
AI Event Overlay： 操作 showAiEventOverlay 将触发该操作的消息副本发送至标签 aievent-CONFIGURATION_ID，并添加 meta.aiEventOverlay: {profile: "CONFIGURATION_ID"}。现有消息字段和对象形式的元数据保持不变；标量元数据保留为 meta.value。这是定向传递，不是新的平台事件。原始消息不会被修改。请参阅设置指南.
可选 meta.aiEventOverlay.variation 选择已保存叠加层设置中批准的完全匹配短语。观众文本和元数据会在生成完成后填入模板字段。
AI Event Overlay 显示请求需要配置及其私有显示令牌。设置和 API 密钥只能通过本地 SSN 弹出窗口管理。响应使用 {aiEventResponse: {target, value}} 或 {aiEventResponse: {target, error}}. 生成结果包含 template, duration, warnings, 可选的媒体数据 URL 位于 image/audio.
使用积分支付的 AI 叠加层奖励通过 aiEventPresentation (id, profile, expiresAt, result, message) 发送，并通过 aiEventDelivered（投递 ID）确认接收。积分扣款记录和退款金额保留在主机端。
Event Flow 可通过设置以下字段请求在停靠面板中置顶： meta.pinned = true；可选的 meta.pinnedTarget 将该置顶限制到具有匹配以下值的停靠面板： label.
Event Flow 热敏打印将结果记录在 meta.thermalPrintResult (success 和可选的 code/error），保留聊天事件和其他元数据。对于具有数字或其他非对象元数据的事件，诊断信息保留在操作结果中，事件保持不变。
可选启用的 SSN 贴图奖励： event: "sticker" 仅发送到 stickers 叠加层标签，在忠诚度积分扣除后使用。它设置 platform 和 type 指向原始消息的 type，并保留 chatname，并且为空的 chatmessage, textonly: true，以及 contentimg 包含打包的相对图像路径或主持人批准的 HTTPS 媒体 URL。 meta.sticker 包含 id, pack, name, cost, duration （秒）， motion, redemptionId，以及 expiresAt （Unix 毫秒）。这是 SSN 奖励，并非平台打赏或原生频道积分事件。请参阅图库和设置指南.
贴图播放器返回控制数据包 {action: "stickerReceipt", meta: {sticker: {redemptionId, success}}} 在图像加载成功或失败时发送给发送方。仅接受来自已连接的 stickers 对等端解决待处理的兑换。交付失败或未确认会触发退款；此控制数据包不是聊天事件。建议每个会话仅保留一个活动贴图显示。
AI 舞台叠加层命令使用 { action: "aiOverlay", target, meta } 或由停靠面板控制的联合主持人播放使用 { action: "cohostOverlay", target, meta }；保留所有命令详情，例如 command, text, emotion, avatar，以及 tts 内部 meta.
如果平台同时提供多个计数器，应优先使用具有明确键的结构化对象（meta.viewer_count, meta.follower_count），而不是让字符串承担多种含义。
商业叠加层应使用位于以下位置的快照对象： meta （例如 auction_update 和 commerce_update），并避免临时添加顶层字段。

平台覆盖范围

YouTube — 标准 DOM 捕获

实现： sources/youtube.js

保持直播聊天标签页打开。捕获功能读取该会话中渲染的会员和礼物卡片；不要求观看者是频道所有者或版主。账号访问权限和所选聊天视图可能影响哪些行可见。
打开观众人数与聊天活动叠加层并显示观众人数时，系统会自动请求观众人数。设置项 显示观众数量 和 跟踪活跃聊天用户 也会启用数据收集。
用于关注者提醒和其他事件，在扩展设置中启用 WebSocket 模式。

事件	触发时机	载荷说明
`sponsorship`	不含明确聊天文本的会员欢迎标题（新会员、赠送套装到账），包括结构化欢迎卡片或本地化的“Welcome to …”文本。	`membership` 填充为翻译后的“MEMBERSHIP”； `subtitle` 检测到时包含连续记录/等级； `nameColor` 允许时使用会员绿色。
`giftpurchase`	赠礼包购买横幅（`ytd-sponsorships-live-chat-gift-purchase`).	`membership` 变为 `gift_giver`; `subtitle` 已知时携带礼物数量；没有 `hasDonation` 或 `donoValue`.
`giftredemption`	面向接收者的礼物兑换公告。	`membership` 变为“MEMBERSHIP”； `subtitle` 包含“Gifted by …”。
`resub`	包含“upgraded to …”的升级横幅。	`subtitle` 捕获新等级标签； `membership` 仍为“MEMBERSHIP”。
`membermilestone`	包含聊天文字的会员里程碑卡片，适用于尚未识别出其他事件类型的情况。	`chatmessage` 包含会员的消息； `membership` 包含会员标签，而 `subtitle` 在检测到时包含会员时长。这表示会员里程碑消息，而非新购或赠送会员。
`superchat`, `supersticker`, `jeweldonation`	Super Chats、Super Stickers、打赏公告卡片，以及由 Jewels 驱动的 YouTube Gifts（`yt-gift-message-view-model`).	`hasDonation` 携带值； `event` 标识 YouTube 付费项目类型。 Super Sticker 图像使用 `contentimg` 与一个空的 `chatmessage`，包括纯文本捕获。 YouTube 礼品用途 `N Jewels` 存在时，或 `1 YouTube Gift` 当 YouTube 隐藏数量时。礼物图像使用 `contentimg`，礼物标签使用 `subtitle`，最少的礼物详情也会镜像到 `meta.youtubeGift`.
`jeweldonation` 礼物效果	YouTube 在直播聊天上方显示动态 Jewel 礼物（`ytls-gift-overlay-item-view-model`).	直接发送到专用 GIF/媒体目标，让动画能够播放而不重复普通礼物行。 `contentimg` 携带动画资源，而 `meta.youtubeGift.animationUrl`/`animationDescription` 保留效果详情。
`reaction`	YouTube 实时表情喷泉中出现观众反应。	直接发送到专用回应目标。匿名表情和图像 URL 保留在 `chatmessage`/`contentimg` 以及位于 `meta.reactionType`/`reactionImage`。已知的直播变体包括 ❤、😄、🎉、😳 和 💯。
`thankyou`	存在打赏金额但未提供聊天文本时使用的回退消息。	保留 `hasDonation` 并为叠加层自动注入“Thank you for your donation!”。
`redirect`	YouTube 重定向横幅出现在直播聊天中（最接近突袭通知的对应内容）。	仅通过 DOM 从以下位置捕获： `yt-live-chat-banner-redirect-renderer`。设置 `event` 为 `redirect` 并使用 `membership` 作为标签，让叠加层像其他系统通知一样渲染它。
`viewer_update`	每 30 秒轮询 Social Stream 的观众数端点（发生配额错误时回退到页面抓取）。	`meta` 是实时观众整数；计入汇总的 `viewer_updates` 在后台脚本中。

会员区块还会设置 membership 用于版主/会员聊天，而 subtitle 携带月数或等级名称。 sourceName/sourceImg 在以下条件成立后填充： getChannelInfo 成功。标准 DOM 聊天现在包含 meta.messageId 当 YouTube 提供原生直播聊天消息 ID 时，停靠面板使用它进行删除同步。

YouTube — Websocket/Data API 捕获

实现： sources/websocket/youtube.html，共享辅助工具位于 shared/

默认使用 OAuth 权限范围 youtube.readonly 和 youtube.channel-memberships.creator。可选写入权限添加 youtube.force-ssl 用于发送聊天、管理、封禁和编辑直播详情；由于 YouTube 不提供仅限聊天的写入权限范围，Google 可能将其显示为广泛的 YouTube 管理权限。
频道统计遵守各项设置的开关（showsubscount, showviewercount).
API 无法提供自定义徽章图像；徽章回退使用下文列出的表情图标。
当 API 明确报告 authorDetails.isChatModerator: true，聊天、Super Chat、Super Sticker、YouTube Gift 和会员赠礼载荷包括 mod: true。不会在事件之间推断或缓存管理员状态。
新订阅者提醒使用 myRecentSubscribers API（每 5 分钟轮询）。注意：结果可能延迟或不完整；只能识别公开可见的订阅。
Data API 不提供 YouTube 重定向横幅，因此 redirect 仍仅可从标准 DOM 捕获中获取。

事件	触发时机	载荷说明
`superchat`	来自 Data API 积压记录或直播轮询的 Super Chat 条目。	`hasDonation` 保留网站金额（货币 + 值）； `event` 为 `superchat`。较旧的 WebSocket 版本使用 `event: "donation"` 用于此行，因此使用方可以继续接受它作为旧版别名。
`supersticker`	Super Stickers，包括已知贴纸 ID 的图像。	`hasDonation` 持有金额；已知贴纸图像使用 `contentimg` 与一个空的 `chatmessage`，包括纯文本捕获。未知 ID 保留描述文本 `chatmessage`.
`jeweldonation`	YouTube `giftEvent` 消息，当观众将 Jewels 兑换为 Gifts 时。	`hasDonation` 保存 `N Jewels`，或 `1 YouTube Gift` 当 YouTube 隐藏数量时； `contentimg` 提供时使用礼物资源 URL； `subtitle` 携带礼物标签； `meta.youtubeGift` 携带额外的礼物详情。
`sponsorship`	新会员通过以下方式加入： `newSponsorEvent`.	`membership` 变为 `new_sponsor` 或 `new_member`; `meta` 包含 `originalEventType`、时长和等级信息。
`resub`	会员续订或等级升级。	`membership` 变为 `renewed_member` （续订）或 `upgraded_member` （升级）； `subtitle` 显示等级。
`giftpurchase`	通过 API 购买的赠礼包。	`membership` 设为 `gift_giver`; `subtitle` 列出数量/等级；没有 `hasDonation` 或 `donoValue`.
`giftredemption`	礼物兑换通知。	`membership` `gift_recipient`；徽章默认为 🎁； `subtitle` 表示赠送的等级。
`membermilestone`	里程碑聊天（`memberMonth` 或 `displayMessage` 存在）。	`membership` `member_milestone`; `subtitle` 汇总月数和等级； `meta` 捕获原始里程碑映射。
`viewer_update`	启用观众报告时的直播统计信息（同时在线观众）。	`meta` 是整数计数；与 DOM 脚本保持一致，以便下游使用方可以合并两条数据流。使用以下设置的停靠面板： `&showviewercount` 请求收集观众数量 70 分钟，并每小时续期，不会永久更改全局设置。
`likes_update`	在以下情况下轮询官方视频统计信息：发送平台点赞总数已启用。	`meta` 是当前视频点赞数整数。它在计数变化时发出，并在不变时定期发出，让使用方保持更新。全局的 `captureliketotals` 设置启用此功能；旧版 `captureyoutubelikes` 仍作为兼容别名。启用弹出窗口中每个停靠面板的 `&showlikecount` 选项还会持久启用这些全局捕获设置，而手动添加 URL 参数仅控制渲染。关闭显示选项不会禁用全局收集。
`subscriber_update`	在以下情况下轮询频道统计（订阅者）： `showsubscount` 未明确禁用。	`meta` 是订阅者总数；界面会更新仪表板计数器。
`view_update`	在以下情况下轮询频道统计（累计观看次数）： `showviewercount` 或 hype 模式处于活动状态。	`meta` 是观看次数整数。
`live_chat_ended`	绑定直播的实时聊天变得不可用。	`meta.streamTitle` 已缓存直播元数据时填充。
`user_banned`	`userBannedEvent` 来自直播聊天 API 或 gRPC 流。	用于管理组件的仅元数据事件。 `meta` 包含用户名/显示名称、频道 ID、头像/个人资料 URL、版主、封禁/禁言时长和是否永久。
`new_follower`	通过以下方式检测到的新订阅者： `myRecentSubscribers` API（每 5 分钟轮询）。	`chatname` 是订阅者的频道名称； `chatmessage` 为空，除非在 YouTube 来源页面中启用了订阅者提醒消息。 `meta` 包含 `channelId`, `title`, `subscribedAt`，分组爆发会添加 `grouped`, `count`, `others`，以及 `subscribers`。注意：结果可能延迟或不完整；只能识别公开可见的订阅。

来自 API 的聊天转发使用 meta.plainText 用于纯文本消息，与富文本 chatmessage 内容。它是文本而非 HTML，仍可包含 Unicode 表情。会员徽章回退为表情（⭐, 💝, 🏅等），以与 DOM 捕获保持一致。普通聊天载荷还包括 meta.messageId 让停靠面板端的删除操作可以往返传回 YouTube 管理 API。

YouTube 订阅者提醒（new_follower)

Social Stream 现在可以使用以下方式检测新的 YouTube 订阅者： myRecentSubscribers API 端点。其工作方式类似于 Streamlabs 订阅者提醒。

工作原理：

每 5 分钟轮询一次 YouTube API，以获取最近的订阅者
在 localStorage 中跟踪已见过的订阅者，以检测新的订阅者
发出 new_follower 事件，带有订阅者的姓名、头像和频道 ID
默认禁用订阅者提醒消息；启用时会使用以下内容的当前翻译字符串： alert-just-subscribed
默认将超过三个新订阅者的集中到达事件分组，避免重连时大量淹没叠加层或 Event Flow
需要在扩展设置中启用 WebSocket 模式

限制（这些是 YouTube API 的限制，而非 Social Stream 的限制）：

不保证交付延迟 — SSN 每五分钟轮询一次，但 API 返回的结果可能有延迟或不完整。不要依赖固定的四小时窗口。
仅限公开订阅 — 将订阅列表设为私有的订阅者不会触发提醒。YouTube 上的订阅默认是私有的。
仅频道所有者 — 您只能接收自己拥有且已完成身份验证的频道的订阅者提醒。
API 配额使用情况 — 每次轮询消耗 1 个 API 单位。以 5 分钟为间隔，每天约使用 288 个单位（默认每日配额为 10,000）。

Event Flow 编辑器触发器： 使用 data.event === "new_follower" 和 data.type === "youtube"

YouTube Websocket：事件和会员速查

`data.event`	`data.membership`	场景
`sponsorship`	`new_sponsor`	通过以下方式加入的新会员： `newSponsorEvent`
`sponsorship`	`new_member`	通过以下方式加入的新会员： `processMembership`
`resub`	`renewed_member`	会员续订
`resub`	`upgraded_member`	等级升级
`giftpurchase`	`gift_giver`	赠送给频道的会员
`giftredemption`	`gift_recipient`	收到赠送的会员资格
`membermilestone`	`member_milestone`	会员周年聊天
`superchat`	-	Super Chat
`supersticker`	-	Super Sticker
`user_banned`	-	仅含元数据的封禁/禁言事件
`new_follower`	-	新订阅者（轮询；可能有延迟）

Twitch — 标准 DOM 捕获

实现： sources/twitch.js

保持 Twitch 聊天打开。Twitch 渲染会员和用户通知时就会捕获这些内容；不限于主播或版主账号。账号专属功能可能需要身份验证。
观众数量请求访问 https://api.socialstream.ninja/twitch/viewers 每 30 秒一次。
用于关注者提醒、raid 和完整事件支持，在扩展设置中启用 WebSocket 模式。
观众分享的连续观看通知默认禁用，需要 显示 Twitch 连续观看记录 设置。
可选启用的 PluralMind 设置可能替换 chatname, nameColor，以及经代理包装的部分 chatmessage，并可能添加代词文本徽章。 username 仍为 Twitch 登录名；相关删除携带 delete.meta.pluralmind 让停靠面板使用该稳定登录名。

事件	触发时机	载荷说明
`reward`	频道积分兑换卡片（包括 7TV 奖励容器）。	`chatmessage` 包含兑换文本； `membership` 保持不变。
`giftpurchase`	系统行，例如“User gifting X Subs in the channel”。	`chatmessage` 是系统行，让叠加层可以突出显示赠送活动。
`subscription_gift`	赠送订阅通知（“用户向……赠送了一份订阅”）。	标记事件以供高亮筛选器使用； `membership` 仍为接收者徽章标签。
`viewer_update`	每 30 秒向 Social Stream 观众数代理获取一次（出错时回退为 0）。	`meta` 整数型观众数量。
`hype_train`	Twitch 置顶社区高亮在弹出聊天中显示正在进行的 Hype Train。	仅含元数据的 DOM 回退方式，带有 `meta.sourceMode` 设为 `dom`。使用可见的等级、计时器和 `meta.progressPercent` 当 Twitch 不提供 EventSub 点数总计时。
`community_highlight`	Twitch“Community Highlight”小组件内的元素。	`meta` 是为自动化挂钩提取的高亮文本。
`knock`	显示在聊天上方的 Stream Together 合作邀请。	`chatmessage` 包含邀请文本； `chatname` 可用时根据提醒用户生成。
`watch_streak`	可选启用、由观众分享并在 Twitch 聊天中渲染的连续观看通知。	`meta.streakCount` 检测到时包含可见计数； `meta.milestoneId` 可用时使用 DOM 通知标识符。

Bits/Cheers 填入 hasDonation （例如“500 bits”），即使 data.event 保持为空；渲染打赏组件时依赖该字段。订阅者连续记录信息出现在 subtitle 当徽章提供月数时。

Twitch — EventSub/Websocket

实现： sources/websocket/twitch.js 使用共享核心 providers/twitch/chatClient.js

OAuth 权限范围： chat:read, chat:edit, user:write:chat, bits:read, moderator:read:followers, moderator:read:chatters, channel:read:subscriptions, channel:read:hype_train, channel:moderate, moderator:manage:banned_users, moderator:manage:chat_messages, channel:manage:broadcast, channel:read:redemptions, channel:read:ads, channel:manage:ads。主播令牌可解锁订阅者/关注者计数。
EventSub 交付事件，并通过 Helix 轮询观众/关注者/订阅者总数。
WebSocket 模式提供实时的 关注者提醒、订阅事件、突袭、cheer、Power-ups、频道点数兑换和 hype train 元数据。
共享聊天行使用 Twitch IRC source-room-id 以填充 sourceName/sourceImg 当原始频道与连接频道不同时，带有原始频道。
观众分享的连续观看通知默认禁用，需要 显示 Twitch 连续观看记录 设置。
可选启用的 PluralMind 设置可能替换 chatname, nameColor，以及经代理包装的部分 chatmessage，并可能添加代词文本徽章。 username 和 userid 保留 Twitch 身份；相关删除携带 delete.meta.pluralmind 让停靠面板使用这些稳定字段。

事件	触发时机	载荷说明
`cheer`	?? IRC ? EventSub ????? `channel.bits.use`.	`hasDonation` “N bits”； `meta.bits` 数值型； `chatmessage` 保留原始消息；已识别的 cheer 发送者包含 `chatimg`.
`powerup`	来自 EventSub 的内置或自定义 Power-up 通知 `channel.bits.use`.	仅含事件的载荷，其中以下字段为空： `chatmessage` 且没有 `hasDonation`，因此不会创建普通聊天行。 `meta.bits` 为数值型，并且 `meta.powerUp` 保留 Twitch 子类型、标题/奖励 ID、效果详情，以及可用时提供的消息文本。
`new_subscriber`	`channel.subscribe` 或带有以下内容的 USERNOTICE： `msg-id=sub`.	`meta` 包含 `{ userId, tier, isGift }`；缓存的订阅者总数在可用时递增；观众总数单独轮询。
`resub`	`channel.subscription.message` 或 USERNOTICE `msg-id=resub`.	`meta` 携带连续和累计月数； `chatmessage` 包含重新订阅文本。
`subscription_gift`	`channel.subscription.gift` 或 USERNOTICE `msg-id=subgift`.	`meta` 提供赠送总数和等级； `chatmessage` 概述该操作。
`reward`	`channel.channel_points_custom_reward_redemption.add`.	`meta` 包含奖励 ID、标题、费用、提示、用户输入、兑换 ID/状态和旧版别名。没有顶层 `reward` 对象由此 EventSub 处理器发出。旧版使用方可能仍显示 `channel_points` 作为已弃用的别名。
`raid`	EventSub `channel.raid` 或 USERNOTICE `msg-id=raid`.	`meta` = { fromId, fromLogin, viewers }.
`watch_streak`	可选启用的 Twitch IRC USERNOTICE，带有 `msg-id=viewermilestone` 和 `msg-param-category=watch-streak`.	在以下字段中包含观众： `chatname`，Twitch 的通知文本位于 `chatmessage`，以及 `meta.streakCount`/`meta.milestoneId`。其他通用 USERNOTICE 类型仍被忽略。
`new_follower`	`channel.follow` EventSub 通知。	自动递增 `follower_update`; `meta` 记录 `{ userId, followedAt }`.
`viewer_update`	Helix `streams` 每 30 秒轮询一次。	`meta` 整数型观众数量；除非在设置中启用观众统计，否则抑制。
`follower_update`	Helix 关注者总数，在关注事件后或定期轮询时触发。	`meta` 整数型关注者数量。
`subscriber_update`	Helix 订阅者总数（需要带有订阅权限范围的主播令牌）。	`meta` 整数型订阅者数量。
`stream_online` / `stream_offline`	EventSub `stream.online`/`stream.offline`.	`meta.startedAt` 在上线事件中存在；离线使用空对象。
`ad_break` / `ad_request` / `ad_schedule`	广告管理 API 响应（`channel.ad_break.begin`，手动的 `POST channels/ads`, `GET channels/ads`).	`meta` 详细提供时长、请求者和计划载荷，以供仪表板使用。
`hype_train`	EventSub `channel.hype_train.begin`, `channel.hype_train.progress`，以及 `channel.hype_train.end` v2 通知。	仅含元数据的事件：没有 `chatname` 或 `chatmessage`. `meta.phase` 为 `begin`, `progress`，或 `end`; `meta` 包含列车 ID、等级、进度、目标、总值、贡献者、时间字段、共享列车标志和 `trainType`。宝藏列车通过以下字段显示： `meta.trainType` 当 Twitch 为它们添加标签时。
`user_banned`	EventSub `channel.ban`，或 IRC `CLEARCHAT` 当 EventSub 封禁事件不可用时的回退方式。	用于管理组件的仅元数据事件。 `meta` 包含用户名/显示名称、用户 ID、头像/个人资料 URL、版主、原因、封禁/禁言时长和是否永久。

聊天载荷复用共享提供程序，因此 data.event 针对 `/me` 填充（action）以及旧版 bits 标签，即使在 EventSub 流程之外也如此。Twitch GIF 消息将 Giphy 资源放在 contentimg，保留 chatmessage 为空，并在以下字段中保留 Twitch 的回退标签： meta.gifLabel。去重和删除逻辑使用消息 ID；通过 SSN 发送的消息使用原生 message_id 来自 Twitch 的 IRC 回显，位于 data.id.

Twitch Hype Train 元数据

hype_train 仅含元数据，不包含 chatname 或 chatmessage。仪表板应通过以下字段更新现有列车显示： meta.id 而不是将每次进度更新作为聊天追加。Meta Data Bar（meta.html）将这些事件显示为顶部进度条。

字段	输入	说明
`type`	字符串	始终 `twitch`.
`event`	字符串	始终 `hype_train`.
`meta.phase`	字符串	`begin`, `progress`，或 `end`.
`meta.id`	字符串	稳定的列车 ID。用它来插入或更新一个可见的列车组件。
`meta.broadcasterUserId`	字符串	Twitch 主播用户 ID。
`meta.broadcasterUserLogin`	字符串	Twitch 主播登录名。
`meta.broadcasterUserName`	字符串	Twitch 主播显示名称。
`meta.total`	数值 \| null	Twitch 为列车报告的支持总值。
`meta.progress`	数值 \| null	朝当前等级目标推进的进度。
`meta.goal`	数值 \| null	当前等级目标。
`meta.progressPercent`	数值 \| null	Twitch 仅提供可见弹出窗口进度条时使用的 DOM 回退百分比。
`meta.level`	数值 \| null	当前或结束时的列车等级。
`meta.topContributions`	数组	主要贡献者。每个条目包含 `userId`, `userLogin`, `userName`, `type`，以及数字形式的 `total`.
`meta.lastContribution`	对象 \| null	最近一次贡献，使用与以下字段相同的贡献结构： `topContributions`.
`meta.sharedTrainParticipants`	数组	Twitch 提供时的原始共享列车参与者数据。
`meta.startedAt`	字符串	列车开始的 ISO 时间戳。
`meta.expiresAt`	字符串	当前列车到期的 ISO 时间戳。
`meta.endedAt`	字符串	列车结束的 ISO 时间戳，结束前为空。
`meta.cooldownEndsAt`	字符串	冷却结束的 ISO 时间戳，结束前为空。
`meta.isSharedTrain`	布尔值	当 Twitch 将列车标记为共享时为 true。
`meta.trainType`	字符串	通常 `regular`；Twitch 对宝藏列车进行标记时，会在这里显示。
`meta.allTimeHighLevel`	数值 \| null	Twitch 提供时，表示列车历史最高等级。
`meta.allTimeHighTotal`	数值 \| null	Twitch 提供时，表示列车历史最高总量。
`meta.sourceMode`	字符串	可选的来源标记，例如 `dom`.
`meta.eventSubType`	字符串	原始 EventSub 类型： `channel.hype_train.begin`, `channel.hype_train.progress`, `channel.hype_train.end`，或 `dom.community_highlight`.

Twitch EventSub：事件速查

`data.event`	场景
`new_follower`	用户关注了频道
`new_subscriber`	新订阅
`resub`	带消息的重新订阅
`subscription_gift`	赠送给频道的订阅
`cheer`	使用 Bits 欢呼
`powerup`	使用了内置或自定义 Power-up
`reward`	频道积分兑换
`raid`	收到的突袭
`viewer_update`	同时在线观众数
`follower_update`	关注者总数
`subscriber_update`	订阅者总数
`stream_online`	直播已开始
`stream_offline`	直播结束
`ad_break`	广告插播开始
`hype_train`	Hype Train/Treasure Train 状态元数据
`user_banned`	用户被封禁或禁言

OBS Flow Actions

实现： actions.html 通过 OBS WebSocket v5 事件，带有 dock.html 将 OBS 浏览器源事件作为回退方式

保持 Flow Actions 叠加层打开，并使用与 Event Flow 编辑器/后台相同的 Social Stream 会话，或者让停靠面板在 OBS 内保持加载。
在 OBS 28+ 上配置 OBS WebSocket v5；默认 URL 为 ws://127.0.0.1:4455.
这些是 Event Flow 系统事件。它们不包含 chatname 或 chatmessage，其他 OBS 详情保留在 meta.

事件	触发时机	载荷说明
`stream_started`	OBS 报告直播输出已达到启动状态。	`type` 为 `obs`; `event` 为 `stream_started`; `meta.source` 为 `obs-websocket` 或 `obs-browser-source`; `meta.outputState` 可能携带原始 OBS 输出状态。
`stream_stopped`	OBS 报告直播输出已达到停止状态。	`type` 为 `obs`; `event` 为 `stream_stopped`; `meta.outputActive` 可能为 `false`.
`recording_started`	OBS 报告录制已开始。	`type` 为 `obs`; `meta.obsEvent` 标识 OBS 事件来源。
`recording_stopped`	OBS 报告录制已停止。	`type` 为 `obs`; `meta.outputState` 可能携带原始 WebSocket 状态。
`scene_changed`	OBS 更改当前节目场景。	`type` 为 `obs`; `meta.sceneName` OBS 提供时包含场景名称。
`media_ended`	OBS 媒体输入播放结束。	`type` 为 `obs`; `meta.inputName` 和 `meta.inputUuid` 标识媒体输入。
`replay_buffer_saved`	OBS 保存回放缓冲区。	`type` 为 `obs`; `meta.savedReplayPath` 可能包含已保存的回放路径。

Streamlabs 提醒框

实现： sources/streamlabs.js （提醒框 DOM）；可选的 socket 桥接位于 sources/websocket/streamlabs.html

让 Streamlabs 提醒框在标签页或浏览器源中保持打开，以便渲染提醒；内容脚本会读取提醒 DOM 中的消息、图像和令牌。
打赏样式的提醒设置 hasDonation （例如“$10 USD”或“100 bits”）以及可选的 donoValue 以美元计。
推断的事件类型： follow, subscription, gift, cheer, donation, superchat, raid, redeem, merch, sponsor.
对于 socket 桥接，粘贴 Streamlabs Socket API 令牌并连接；无需提醒框页面即可转发提醒。

事件	触发时机	载荷说明
`donation`	打赏、慈善、JustGiving 或通用的“donated”提醒。	`hasDonation` 保留货币文本（例如“$36”或“$10 CAD”）； `donoValue` 仅在美元值可用时提供；其他带标签的金额使用共享货币换算。
`cheer`	Twitch bit/cheer 提醒。	`hasDonation` 变为“100 bits”，而 `donoValue` 捕获美元值。
`subscription`	订阅提醒。	已设置标准字段； `chatmessage` 是提醒行； `meta.tokens` 携带标记化的值（name、amount、levelName 等）。
`gift`	赠送的会员/订阅。	`meta.tokens.amount` 可能显示礼物数量； `meta.tokens.levelName` 可存放等级。
`follow`	关注者提醒。	没有打赏字段； `chatname` 反映提醒名称标记。
`raid`	突袭提醒。	`meta.tokens.count` 存在时保存突袭人数。
`redeem`	Cloudbot 兑换提醒。	`meta.tokens.product` 捕获兑换物品。
`merch`	周边商品购买提醒。	`meta.tokens.product` 包含已购买商品的名称。
`superchat`	来自 YouTube 或受支持提醒集成的 Super Chat 样式提醒。	`hasDonation` 携带金额；使用方可以继续接受旧版的 `donation` 别名。
`sponsor`	由 Streamlabs 显示的赞助者/会员样式提醒。	标准字段；除非文本包含金额，否则不含打赏。

TikTok Live — DOM 捕获和 TikFinity 信息流

Fan Club level: TikTok chat messages include meta.teamMemberLevel when an explicit Team level or numeric Fan Club badge level is available. It is a non-negative integer; 0 is an explicitly supplied zero, while an absent field means unknown. It excludes user-grade/gifter ranks and levels inferred from badge image filenames. Standard capture reads the numeric Fan Club badge metadata attached to each rendered chat message. The TikFinity activity-feed widget does not supply this field. For minimum-level filtering, use Compare Property → TikTok Team Level together with a TikTok source condition; messages with unknown levels do not match. The older meta.memberLevel field has capture-dependent meaning and should not be used for an exact Fan Club threshold.

实现： sources/tiktok.js 用于原生 TikTok 页面，以及 sources/tikfinity.js TikFinity 的活动提要小部件/iframe。 SSApp 仍然具有本机 TikTok 集成和最广泛的事件覆盖范围（请参阅 SSApp 文档）。标准聊天包括 meta.messageId 当页面公开本机消息 ID 时；具有相同文本的不同消息保留不同的 ID。

在主播的直播页面上运行。礼物/点赞/关注横幅仅在会话经过身份验证时填充。
TikTok 通过 DOM 检测提供多种事件 无需 WebSocket 模式 — 礼物、关注、点赞和可选启用的加入通知从渲染的行中捕获。
TikFinity 组件页面位于 tikfinity.zerody.one/widget/activity-feed* 也适用。嵌入的活动信息流 iframe 为聊天、关注、分享、礼物、订阅、可选启用的加入通知和宝箱发出相同的规范 TikTok 载荷字段。
无需额外的 API 身份验证。
SSApp 原生模式 仍会在页面/组件捕获路径之外添加事件： question_new, emote, viewer_update，以及需主动启用的汇总 likes_update.

事件	触发时机	载荷说明
`gift`	礼物横幅行或 `DivGiftMessage` 条目。	`hasDonation` 转换为“N coins”（以礼物查询作为回退方式）； `membership` 可用时使用徽章文本。
`joined`	全局设置启用时的加入通知：捕获“joined”直播事件设置已启用。	跳过分享通知； `chatname` 对于某些系统字符串可能为空。
`followed`	从社交卡片解析的关注消息。	确保 `chatname` 在发出之前存在。
`shared`	TikFinity 分享行。	`chatmessage` 是渲染的分享文本。
`subscribe`	TikFinity 订阅行。	`membership` 设为 `SUBSCRIBER`.
`envelope`	TikFinity 宝箱行。	`meta.coins` 和 `meta.canOpen` 携带宝箱详情。
`liked`	由 TikTok 社交卡片触发的点赞风暴摘要。	`chatname` TikTok 提供时会包含；匿名/系统点赞卡片仍可能发出。TikTok 通过普通后台路径发送此内容。后台将一份副本路由到 Reactions Overlay，然后仅在以下条件成立时继续进入主聊天/事件处理管线： `capturelikeevent` 已启用。
`likes_update`	SSApp 收到权威的 TikTok LIVE 累计总数，而 `captureliketotals` 已启用。	`meta` 是当前总数整数。SSApp 立即发送第一个值，将突发更新合并为最多每五秒一次，约每 90 秒重复最新值，并在直播结束时发送零。这与特定观众的以下内容分开： `liked` 事件。
`true` （布尔值）	TikTok 未提供子类型的通用社交/系统广播。	使用 `chatmessage` 内容来决定展示方式；布尔值 `true` 表示“系统事件 — 类型未知”。

membership 对应徽章工具提示（订阅者等级）。头像缓存使 chatimg 在事件之间保持有效；如果 DOM 隐藏版主颜色，脚本会清除 nameColor. TikFinity 活动源捕获支持旧版码头和新码头 widgets.tikfinity.com 浏览器源 URL。新 stream_event 消息被转换为此处描述的相同聊天、礼物、关注、共享、订阅、加入和信封有效负载。 TikFinity 礼品行也设置了当源提供时， contentimg 到礼物图标（如果有）。对于带有明显条纹的礼物 repeatEnd 标志，TikFinity 仅发送已完成的连胜及其最终数量；不转发中间计数更新。非条纹礼物和没有该标志的旧有效负载将立即继续。原生 DOM 礼物连续更新和 TikFinity 礼物行包括 meta.tiktokGiftStreakId, meta.tiktokGiftCount，以及 meta.tiktokGiftQuietMs 让叠加层可以合并重复更新；旧版连续记录 ID 对每个页面实例唯一。礼物元数据还可能包含 tiktokGiftMessageId （原始 TikTok 消息 ID）， tiktokGiftSenderId, groupId, giftId, giftName, streakable，以及 repeatEnd。原生 ID 用于识别不同捕获窗口中的同一礼物；非零组 ID 配合发送者和礼物 ID，用于识别累计连送更新。SSApp WebSocket 捕获在连送结算后提供相同字段，并带有 count 为兼容性而保留。转发每个礼物时都会检查其打赏开关：禁用 TikTok 打赏会移除 hasDonation 和 donoValue 同时保留礼物事件和元数据。TTS 使用这些身份合并更新，并在最长十分钟内抑制已完成的重复项（有界缓存），按发送者、数量和礼物名称朗读 TikTok 礼物。旧版载荷回退到现有连送 ID 和消息文本；不会仅从礼物文本推断身份。TikTok 礼物语音使用所选的 TTS/语音语言，独立于界面语言。播报动词已针对英语、西班牙语、葡萄牙语、法语、德语、意大利语和荷兰语本地化；其他语言使用发送者、数量和礼物名称，不带英语动词。简化 TTS 保留这种中性格式。礼物名称保持平台提供的原样；这不会自动翻译礼物目录或聊天消息，也不会推断直播语言。

对于这些连送更新，计数和打赏标签是累计值：1、2、3 表示三件礼物，而不是六件。总数使用方应只增加超过该连送 ID 已见最大值的部分。Standard 捕获支持旧版礼物类和当前的图片/计数行；两者都保留 event: "gift" 和 hasDonation。价格未知时保留礼物数量/名称用于显示，并以每件礼物一枚金币估算美元值。来源提供的 donoValue 优先；渲染的礼物元数据可能提供 coinsPerGift 或 diamondsPerGift 然后才需要使用礼物表或默认值。标准模式/TikFinity 的金币估算与 SSApp 原生的钻石估算使用各自现有的不同换算方式；两者都不代表有保证的现金收益。

Whatnot

实现： sources/whatnot.js

使用 SSApp 中的 Whatnot 源进行没有视频的公共聊天和拍卖活动，或打开现场表演页面进行网站捕获。两者都连接到公开拍卖源。网站捕获还读取渲染的拍卖和目录部分。
捕获直播事件 控制 Whatnot 系统事件和拍卖/目录元数据更新；加入行还需要 捕获“joined”直播事件；观众计数仍遵循观众/Hype 开关。

事件	触发时机	载荷说明
`viewer_update`	来自 websocket 直播更新的观众数量变化，以 DOM 轮询作为回退方式。	`meta` 是整数型观众数量。
`donation`	Whatnot websocket 打赏和社区 boost 贡献事件。	`hasDonation` 包含格式化的金额；websocket 专属上下文保留在 `meta`.
`raid`	Whatnot websocket 突袭事件，包括积压活动回复。	`meta.numRaiders` Whatnot 提供时会包含。
`joined`	规范化正文以以下内容开头的聊天行： `joined`，当捕获“joined”直播事件已启用。	加入通知使用字符串事件标签（而非布尔值 `true`).
`auction_update`	直播页脚拍卖状态变化时（获胜者/领先文本、标题、出价、价格、计时器、已售状态），通常由 websocket 拍卖生命周期数据包加速。	仅含元数据的事件。没有 `chatname`/`chatmessage`；数据位于 `meta` （例如 `meta.title`, `meta.bids`, `meta.price`, `meta.timer`, `meta.status`).
`commerce_update`	商品目录区段变化时（商品、惊喜套装、即将举行的赠品抽奖），通常由 websocket 赠品抽奖/商品生命周期数据包加速。	仅元数据更新。网站部分快照使用 `meta.products`, `meta.surpriseSets`，以及 `meta.upcomingGiveaways`。公开赠品更新使用 `meta.giveaway.productId` 和 `meta.giveaway.entryCount`。固定项目更新使用 `meta.pinnedItems`，包含提供的类型、ID、产品 ID 或名称。 `meta.websocketEvent` 识别 `giveaway_entry_count_updated` 或 `pinned_item_updated`;未改变的状态被抑制。
`auction_started`, `new_bid`, `auction_ended`, `product_sold`	收到相应的实时 websocket 通知。这些是独立事件，与现有的显示快照分开。	`platform/type: "whatnot"`，纯文本的 `chatname`, `userid` 提供时，商品名称位于 `subtitle`，以及纯文本的 `chatmessage` 带有 `textonly: true`。可用标识符和拍卖详情位于 `meta`: `productId`, `auctionId`, `orderId`, `transactionId`, `livestreamId`, `bidId`, `bids`, `auctionEndTime`，以及 `status`。可选的 `price` 使用主要货币单位，带有 `priceText` 和 `currency` 提供时。
`giveaway_started`, `giveaway_won`	公开拍卖提要宣布赠品开始或获胜者。	使用所提供的产品和获胜者的拍卖事件字段。 `meta.entryCount` 包含提供时的条目计数。参赛者名单和原始订单详细信息不会转发。
`payment_failed`	收到实时支付失败 WebSocket 通知。	相同的可用买家、商品和标识符字段，带有 `meta.paymentStatus: "failed"`。仅当 `product.purchaserUserId` 标识买家，并填充 `userid` 用于销售/付款事件，且买家姓名保持为空。不会根据其他或之前的拍卖推断买家。
`payment_succeeded`	收到实时支付成功 WebSocket 通知。	`meta.paymentStatus: "succeeded"`，包含该通知提供的买家、商品、订单 ID 和其他允许字段。这仍是独立的支付事件；不会再发出一个 `purchase` 或打赏。缺失字段保持为空或省略，即使之前的销售提供过这些字段。

拍卖/商业展示更新仍是基于 DOM 的快照。要在 Event Flow 中匹配单个 WebSocket 事件，请使用 事件类型（高级）（Event Type (Advanced)），选择 自定义事件（Custom Event），并输入其准确名称。标签可以使用 **{username}**\n{subtitle} 带有所选文本权重；条件可以比较 meta.paymentStatus 带有 failed。一个可导入的 Whatnot 标签示例可用。现有直播事件捕获设置仍然适用。

其他可选字段包括 meta.catalogProductId （数据包的 product.productId), meta.parentProductId (product.parentId), meta.transactionType （Whatnot 的销售类型，保持不变），以及 meta.placeOrderErrorReason （Whatnot 提供的订单/支付错误代码）。这些商品引用描述的是目录或父级商品页面，不能替代订单 ID。库存数量不视为购买数量。

要自动处理支付成功，请设置一个 事件类型（高级）（Event Type (Advanced)） 触发器，以 自定义事件（Custom Event）: payment_succeeded，并将来源筛选为 Whatnot。现有条件和模板可以使用该事件的 userid, chatname, subtitle 和 meta.orderId 直接处理。通知包含所需详情时，不需要已记忆的购买记录。

拍卖结束或商品被标记为已售出，并不确认付款成功：这些通知不会作为已付款的 purchase 事件，且不设置打赏金额。只有收到以下内容才会发出成功事件： payment_succeeded 通知；捕获不会轮询付款完成状态，也不会根据销售推断付款完成。其他 paymentStatus 仅当在捕获的数据包中显式提供时才会转发值。遗漏的标识符被省略；一个产品 ID 可能涵盖多个销售，因此请使用提供的订单/拍卖 ID 来关联通知。 Capture 不记得购买或匹配付款更新；任何此类工作流程都必须在事件流中显式配置。具有相同本机事件时间戳/ID 的重复商务通知在重叠通道中被抑制，并在 2,000 个事件缓存内重新连接。没有本机事件标识的数据包使用简短的重复窗口。原始订单/付款对象不会被转发。

eBay Live

变现功能中的 eBay 卖家连接需要配置 SSN eBay 服务并获得卖家 OAuth 授权；下文的 eBay Live 捕获独立运行。沙盒模式使用沙盒商品 URL，将买家标记为“eBay Sandbox buyer”，并为消息添加“Sandbox test purchase:”前缀。沙盒购买保留相同的购买数据约定，并可在测试期间触发已启用的提醒/聊天操作。其已实现的付款数据约定会发出 event: "purchase"，带有 type 和 platform 设为 ebay。需要一笔与所选商品匹配的已付款订单。 id 是稳定、不透明的订单行标识符； chatname 为“eBay buyer”， chatmessage 是纯文本（textonly: true), subtitle 是商品名称和可选的 contentimg 是其图像。 meta.ebayPurchase 包含 itemId, itemName, quantity，以及公开的 url。没有买家身份、配送数据、 hasDonation 或 donoValue 已包含。这不同于抓取的拍卖或库存更新，后者不能证明已付款。

实现： sources/ebay.js

打开其中任意一个 /ebaylive/events/<id>/chat 或 /ebaylive/events/<id>/stream。两者接收同一实时拍卖 feed。
公开的 WebSocket 信息流提供拍卖、出价、获胜者、计时延长和库存变化；只读 GraphQL 查询提供商品详情。当网络数据不可用时，DOM 捕获仍作为回退方式。
捕获直播事件 控制元数据快照（auction_update, commerce_update）；观众计数器仍遵守观众/Hype 开关。

事件	触发时机	载荷说明
`viewer_update`	当前活动观众数量变化时（标题栏计数，或直播活动标记回退值）。	`meta` 是整数型观众数量。
`follower_update`	卖家统计端点返回卖家关注者数量时。	`meta` 是整数型关注者数量。来源每 60 秒轮询一次卖家端点；该端点仍可能返回最长缓存 5 分钟的值。
`auction_update`	当前拍卖元数据变化时。	仅含元数据的事件。网络捕获会设置 `meta.sourceMode` 为 `network` 并提供 title、price、bidder、winner、bids、timer 和 endingAt。 `meta.ebay` 包含 eventId、listingId、GraphQL 商品记录（`listing`）、当前的公开 socket 商品信息（`eventListing`），以及最新的拍卖更新（`update`）。这些字段保留类别、图片、货币、数量、拆盒详情、拍卖结果和时间字段，不会因扁平化而丢失平台细节。GraphQL 记录是获取到的快照；socket 商品信息和更新携带更新的直播状态。初始/重连历史会合并到当前快照中，而不会作为旧的获胜事件发出。移除所有展示的商品时会发出 `status: "idle"` 带有 `cardCount: 0` 以清除拍卖。DOM 回退保留播放器卡片或活动预览字段。
`commerce_update`	目录/直播事件快照区段变化时。	位于以下字段中的仅元数据快照： `meta`。网络模式包括 `eventId`, `navigation.viewerCount` 和 `playerCards` 用于当前展示的商品，每项都有相同的详细 `ebay` 对象作为拍卖快照。空卡片列表会清除已移除的商品。DOM 回退还可能包含 `liveEvents`, `livePreview`, `currentEvent` 和 `upcomingEvents`.
`reaction`	eBay Live 渲染爱心/回应动画时。	直接发送到专用回应目标。 `meta.reactionType` 为 `heart`；eBay 不会为这些 DOM 动画提供逐用户名称。

eBay 元数据事件有意省略 chatname/chatmessage；下游叠加层应从以下字段渲染： data.event + data.meta 仅此。

Kick — 标准 DOM 捕获

实现： sources/kick.js.聊天包括 meta.messageId 当页面公开本机消息 ID 时。

需要经过身份验证的会话才能解析个人资料图像和订阅者徽章。
通过聊天文本匹配和徽章进行有限的事件检测；启用开关后，观众数量仍然有效。

事件	触发时机	载荷说明
`gift`	通过贴图图像和可见的 Kick 货币金额检测到的 KICKs 礼物。	`hasDonation` 携带 `N KICKs` (`1 KICK` 表示一个），前提是可见金额可用； `contentimg` 携带礼物图像。现有消息文本会保留。
`reward`	奖励兑换（“has redeemed …”）。	`chatmessage` 包含兑换文本。
`true` （布尔值）	不匹配礼物或奖励模式的通用系统通知。	使用 `chatmessage` 内容来决定展示方式；布尔值 `true` 表示“系统事件 — 类型未知”。
`viewer_update`	每 30 秒轮询一次 Kick 的频道 API（仅在启用观众统计信息时）。	`meta` 整数型观众数量；订阅、关注或打赏请使用下方的 Kick 桥接。

Kick — Websocket/桥接

实现： sources/websocket/kick.js 使用位于以下位置的共享辅助程序： providers/kick/core.js

通过 Social Stream Kick 桥接进行 OAuth。当前权限范围为 user:read, channel:read, channel:write, channel:rewards:read, chat:write, events:subscribe, moderation:ban, moderation:chat_message:manage，以及 kicks:read。令牌会自动刷新。
Kick webhook 配置可能需要几分钟；界面会按频道列出有效订阅。

事件	触发时机	载荷说明
`message`	桥接聊天载荷。	`meta.plainText` 包含纯文本消息（仍可包含表情）；徽章合并平台和个人资料缓存。串内回复填充 `initial`, `reply`，以及 `meta.reply` 当回复详情或已缓存的父消息可用时。
`reward`	`channel.reward.redemption.updated`，以及看起来像兑换事件的桥接聊天/系统载荷。	`meta` 包含奖励/兑换 ID、标题、费用、状态、用户输入和兑换者。
`new_subscriber`	`channel.subscription.new`.	`membership` 分配给订阅者角色； `meta` 包含 { subscriber, plan }。
`resub`	`channel.subscription.renewal`.	`meta.duration` （月）以及 `meta.plan` 可用； `subtitle` 汇总连续记录。
`subscription_gift`	`channel.subscription.gifts`.	`meta.totalGifted`, `meta.gifter`；徽章回退到 💝 图标。
`donation`	通过事件类型启发式规则检测的支持/打赏事件；KICKs 礼物使用 `gift` 如下。	`hasDonation` 携带格式化的金额； `meta` 包含 { amount, currency, supporter, message, giftName }。
`gift`	`kicks.gifted` （KICKs 礼物），与 DOM 抓取器一致。	`hasDonation` 携带 `N KICKs` (`1 KICK` 表示一个）； `contentimg` 可用时携带礼物图像。结构化礼物详情保留在 `meta`.
`raid`	兼容处理旧版 host 形状的 socket 载荷，例如 `App\Events\StreamHostEvent`.	Kick 当前的官方事件目录没有 raid/host 订阅。如果收到兼容的旧版载荷，会将其映射为规范的 `raid`；不要在当前 Kick 工作流程中依赖此项。
`new_follower`	`channel.followed`.	关注者图标来自个人资料缓存； `follower_update` Kick 提供累计总数时触发。
`follower_update`	桥接在 webhook 载荷中提供关注者计数。	`meta` 整数型总数；由仪表板用于关注者目标。
`stream_online` / `stream_offline`	`livestream.status.updated`.	`meta` 包含来自 Kick 的原始状态正文（is_live、title 等）。
`viewer_update`	`livestream.status.updated` 当 Kick 包含同时在线观众总数时。	`meta` 整数型观众数量；发出 `0` 在离线状态时，用于清除过期计数器。
`user_banned`	`moderation.banned` 来自桥接/webhook，或 Kick 聊天 socket 封禁事件。	用于管理组件的仅元数据事件。 `meta` 包含用户名/显示名称、用户 ID、头像/个人资料 URL、版主、原因、封禁/禁言时长和是否永久。

个人资料查询使用 profileCache; mapBadges 可用时将 Kick 的徽章资源与缓存的 SVG 合并。当 Kick 以 KICKs 报告打赏时，桥接将其转换为 hasDonation 加上 meta.amount 带有 currency 回退为“KICKs”。聊天载荷包含 meta.messageId 当桥接提供原生 Kick 消息 ID 时，让删除同步能够定位正确消息。回复载荷包含 meta.reply 带有父级 messageId, author，以及 text 已知时。即使原始消息未缓存，提供的回复详情仍然可用；没有缓存上下文、仅有 ID 的回复仍可能缺少可见引用。

Kick Websocket：事件速查

`data.event`	场景
`new_follower`	用户关注了频道
`new_subscriber`	新订阅
`resub`	订阅续订
`subscription_gift`	赠送的订阅
`reward`	频道奖励兑换，或奖励样式的聊天/系统消息
`donation`	打赏/支持事件
`gift`	KICKs 礼物事件
`raid`	仅用于兼容的旧版 host/raid 输入；不是当前官方 Kick 订阅
`follower_update`	关注者总数
`stream_online`	直播已开始
`stream_offline`	直播结束
`user_banned`	用户被封禁或禁言

VPZone — WebSocket

实现： sources/websocket/vpzone.js

连接到 wss://chat.vpzone.tv/ws?channel=USERNAME；OAuth 请求 profile:read, chat:read, chat:write, channel:read, channel:write，以及 chat:moderate。也可以手动提供 bearer 令牌。
扁平 VPZone 帧，例如 type: "msg" 被标准化为标准聊天载荷。
平台端 delete_message / clear_chat 框架从扩展坞中删除匹配的行。删除携带 meta.streamUsername 选择频道并 meta.messageId 当定位本机消息 ID 时。可选切换同步底座删除和阻止回 VPZone（仅限频道所有者）。
频道所有者会获得页面内的 Stream Info 面板，用于更新直播标题和类别（与 Twitch 来源页面的模式相同）。

事件	触发时机	载荷说明
`message`	VPZone `msg`, `message`, `new_message`，或 `chat_message` websocket 帧。	`chatname` 来自 `username`; `chatmessage` 来自 `body`；subscriber/owner/mod/VIP 标志复制到 `chatbadges`、顶层角色标志，以及 `meta`。原生 ID 填入 `data.id` 和 `meta.messageId`.
`viewer_update`	VPZone `presence` 帧，带有 `count` 或等效的观众字段。	`meta` 是实时观众整数；计入汇总的 `viewer_updates`.
`new_subscriber`	VPZone `subscribe` / `subscription` 帧。	`membership` 存在订阅标志时设为 Subscriber。
`subscription_gift`	VPZone `gift` / `gift_subscription` 帧。	使用与 Twitch、Kick、Rumble 和 Velora 相同的赠送订阅事件名称。 `subtitle` 携带礼物数量（`x5`）或接收者。
`message` + `hasDonation`	VPZone `system` 帧，带有 `metadata.kind: "pixels_cheer"` （Pixels 打赏）。	带有打赏的聊天行； `hasDonation` 是金额标签（例如 `100 Pixels`), `meta.pixels` 该整数。 `event` 保持为空；通过以下字段检测此打赏： `hasDonation`。Kick 桥接的支持事件改用 `event: "donation"`.
`message` 回复	VPZone `msg` 帧，携带 `metadata.reply_to` （消息 ID、作者、摘录——在服务器端反规范化）。	与 Kick 回复一样渲染： `initial` 保存“author: excerpt”标签， `reply` 原始回复文本， `meta.reply` 结构化目标。遵循排除“replying to” 设置。
`raid`	VPZone `raid` 帧，带有 `metadata.kind: "incoming"`.	跳过传出的突袭帧； `meta.viewers` 提供时携带突袭人数。
`shoutout`	VPZone `shoutout` 帧（`!so` 命令）。	`meta.targetUser` 给出被推荐的频道名称。
`reward`	VPZone `system` 帧，带有 `metadata.kind: "channel_points_redeem"`.	频道积分兑换，使用与 Twitch 奖励相同的事件名称。
`stream_online` / `stream_offline`	VPZone `system` 帧，带有 `metadata.kind: "stream_started"` / `"stream_ended"`.	归属为频道名称（帧中不包含行为人）。
`new_follower`	VPZone `follow` 帧。	映射为标准关注者事件结构。
`joined`	VPZone 加入/在线状态样式的 websocket 事件，在以下情况下：捕获“joined”直播事件已启用。	映射为聊天样式的系统事件，VPZone 行为者元数据位于 `meta`.

Joystick

实现： sources/joystick.js, sources/inject/joystick-ws.js，以及 sources/websocket/joystick.js

普通 Joystick 2.0 网站来源运行于已登录的 /u/<channel>/chat 页面。它读取页面的 ChatChannel, WhisperChatChannel, EventLogChannel，以及 SystemEventChannel Action Cable 帧，并为 Electron 和重连情况提供基于已渲染行的回退。
网站聊天消息使用与 YouTube、Twitch 和 Kick 相同的核心字段：原生 id, chatname, chatmessage, chatimg, chatbadges, nameColor, membership, mod, private, username/userid，以及 timestamp 当 Joystick 提供它们时。当 socket 省略用户名颜色时，渲染的行提供相同的 nameColor 由启用颜色的停靠面板使用的字段。
网站端的消息编辑会替换匹配的停靠面板行；删除、静音和屏蔽会使用原生 ID 或用户名移除匹配行。
单独的 WebSocket 来源使用 Joystick 机器人凭据（client_id + client_secret）；网站来源使用已登录的页面会话。
在以下地址授权： https://joystick.tv/api/oauth/authorize，然后在以下地址交换/刷新令牌： https://api.joystick.tv/api/oauth/token.
连接到 wss://api.joystick.tv/cable 并订阅 GatewayChannel.
可选的 OAuth 令牌交换用于辅助端点，例如 https://api.joystick.tv/api/users/stream-settings.
单独的机器人凭据来源不会发出 viewer_update。已登录的网站来源在页面 socket 提供观众数时确实会发出观众数，如下所述。

事件	触发时机	载荷说明
`message`	Joystick `ChatMessage`, `BotMessage`, `new_message`, `bot_message`, `event_bot_message`, `pvp_message`，以及私信。	普通聊天没有 `event`。原生 ID 放在顶层 `id` 和 `meta.messageId`；角色和私有状态使用既有顶层/徽章字段。
`new_follower`	Joystick `StreamEvent` 类型为 `Followed`.	使用标准关注者结构，并与 Joystick 匹配的机器人行进行去重。可选的 `meta.userId`/`meta.followedAt` 仅在 Joystick 提供时包含。
`new_subscriber` / `subscription_gift`	Joystick 事件类型 `NewSubscription` / `GiftedSubscription`.	使用与 Kick 兼容的订阅元数据键： `eventType`, `subscriber`, `gifter`, `totalGifted`, `duration`，以及 `plan`.
`donation`	Joystick `StreamEvent` 类型 `Tipped` / `TipMenu`.	`hasDonation` 可用时携带代币金额和单位，以供共享美元换算，并对匹配的 Joystick 机器人行去重。 `meta` 使用现有的 Kick 支持事件键： `eventType`, `supporter`, `amount`, `currency`, `message`, `giftName`, `giftType`，以及 `tier`.
`stream_online` / `stream_offline`	Joystick `StreamEvent` 类型，例如 `Started`, `StreamResuming`, `Ended`, `StreamEnding`.	用于能识别传输状态的上线/离线自动化。
`user_enter` / `user_leave`	Joystick `UserPresence` 类型 `enter_stream` / `leave_stream`.	在线状态通知作为事件消息发出，可通过隐藏事件设置抑制。隐藏事件还会抑制非打赏的直播事件。
`viewer_update`	已登录的网站来源接收 `ViewerCountUpdated` 通过 `EventLogChannel`.	使用纯整数 `meta`，与 YouTube、Twitch 和 Kick 一致。仅在启用观众计数或 Hype 模式时发出。单独的机器人凭据来源仍不会接收观众数。
`follower_update` / `subscriber_update`	Joystick 关注者/订阅者数量更新事件。	使用纯整数 `meta`，与 Twitch 计数器约定一致。
被忽略的内部通知	`ChatMessageReceived`、设备状态，以及未映射的小组件刷新，例如打赏目标/PvP/subathon 状态。	这些是传输或页面状态通知，并非 Social Stream 事件。它们不会被转换为虚构的 `snake_case` 事件名称；实际的 `ChatChannel/new_message` 行仍是唯一的聊天载荷。

XP Sync

实现： sources/xpsync.js

聊天行使用规范载荷字段，并带有 type: "xpsync"，包括作者、消息、头像、图片和内联 SVG 徽章、名称颜色、会员状态、管理员/会员/机器人标志，以及作为以下字段的原生消息 UUID： id 可用时。
回复遵循 YouTube、Twitch 和 Kick DOM 来源的约定：除非禁用回复前缀，否则 initial 包含被回复的用户， reply 保留不带前缀的消息，而 chatmessage 接收可见的回复前缀。
即使 XPSync 在渲染 Sparks 高亮行时不使用普通聊天行类名或消息 ID，这些行也会被捕获；可见金额通过以下字段提供： hasDonation 作为 N Sparks.
启用事件捕获时，包含“just followed”或“followed the channel”的行会发出 event: "new_follower".
启用观众数量时，永久聊天停靠面板发出 event: "viewer_update" 来自 XPSync 页面已加载的直播视频计数，并通过 XPSync 的直播页面更新刷新。无需单独的 SSN 凭据。

Instagram — 直播 REST 捕获和新闻收件箱

实现： sources/instagram.js 和 sources/instagramlive.js (identical copies), plus the optional Graph API bridge at sources/websocket/instagram.html

The API bridge polls Graph API comments for one chosen media item. A live video emits type: "instagramlive" and a post or Reel emits type: "instagram"; platform carries the same value. Comments are plain text (textonly: true) with an empty chatimg, userid when the API returns the author ID, and timestamp in Unix milliseconds when valid. meta.messageId is the native comment ID and meta.mediaId the media it belongs to. Comments that already exist when capture starts are shown on the page as history and not forwarded; hidden comments are skipped.
在直播页面上（/<user>/live/?broadcast_id=...），直播聊天来自 Instagram 自己的 Web API，使用会话 cookie 在同源进行轮询： GET /api/v1/live/{broadcast_id}/get_comment/?last_comment_ts={ts} 约每 2 秒一次，而 POST /api/v1/live/{broadcast_id}/heartbeat_and_get_viewer_count/ 启用观众数量时约每 5 秒一次。连续失败 3 次后（或没有 broadcast_id 可发现）时，来源会回退为解析渲染的聊天 DOM。
通过以下方式轮询账号自身的活动信息流： POST /api/v1/news/inbox/ 在任何 Instagram 页面上约每 45 秒一次。第一次轮询仅初始化去重集合，因此绝不会重放积压记录；快拍依据以下字段去重： tuuid.
必需的 API 请求头（全部为静态值或可推导值）： X-IG-App-ID: 936619743392459, X-CSRFToken （来自 cookie）， X-ASBD-ID: 359341, X-Requested-With: XMLHttpRequest, Content-Type: application/x-www-form-urlencoded.
所有活动 feed 事件均使用 type: "instagram"；直播聊天保持为 type: "instagramlive"。点赞事件使用正常的后台路径：后台先向专用 Reactions Overlay 发送一份，然后仅在以下情况下将其纳入主聊天/事件 feed： capturelikeevent 已启用，与 TikTok 和 MeetMe 一致。 hideevents 和自定义事件筛选器会在所有位置阻止它们。由于收件箱事件属于已登录的账号，在观看他人直播时会抑制这些事件（两种 /<user>/live/ 页面和快拍查看器中的直播；按个人资料解析所有权，并在查询失败后重试），并在您自己的直播及所有非直播页面上发出。一次仅有一个活动 Instagram 标签页轮询账号收件箱，且仅在已登录时运行轮询。

事件	触发时机	载荷说明
`message` （直播）	以下位置的新条目： `get_comment` 响应（`comments[]`/`system_comments[]`），或者在 REST 不可用时捕获新的 DOM 聊天行。	标准聊天载荷， `type: "instagramlive"`。REST 提供准确的 `user.username`, `user.profile_pic_url`，以及唯一的 `pk` 用于去重。
`viewer_update`	`heartbeat_and_get_viewer_count` 报告变化的 `viewer_count`，在启用观众数捕获或 Hype 模式时。	`meta` 整数型观众数量。在以下情况下停止轮询： `broadcast_status` 不再是 `"live"`.
`stream_online` / `stream_offline`	`stream_online` 在 REST 直播会话开始时触发一次； `stream_offline` 心跳报告非直播的以下内容时触发： `broadcast_status` （需要观众数捕获或 Hype 模式）。	与 Twitch 和 Joystick 使用的共享直播状态词汇一致的仅元数据事件。
`new_follower`	带有关注类型的动态收件箱条目 `notif_name` （或 `story_type 12`）出现。	`chatname` 是新关注者， `chatimg` 其个人资料图像， `chatmessage` 收件箱文本（例如“x started following you.”）。
`follow_request`	一个 `private_user_follow_request` 快拍出现（私有账号收到的是请求，而非直接关注）。	结构与以下内容相同： `new_follower`，保持区分，以便自动化批准请求或使用不同的问候。
`liked`	带有点赞类型的动态收件箱条目 `notif_name` （包括 `comment_like`）出现。	与 TikTok/MeetMe 共用的点赞词汇。 `chatname` 是行为者， `chatmessage` 收件箱文本（例如“x liked your photo.”）。
`message` （自己帖子上的评论）	带有评论类型的动态收件箱条目 `notif_name` 出现。	普通聊天行（`event: false`), `type: "instagram"`; `chatmessage` 携带收件箱文本，包括评论摘录。
`notification`	任何其他动态收件箱条目类型（提及、标签、购物等）。	通用兜底项； `meta.notifName` 和 `meta.storyType` 保留原始快拍分类。

Facebook Live

实现： sources/facebook.js （DOM 抓取）以及位于以下地址的可选 Graph API 桥接： sources/websocket/facebook.html

DOM 捕获读取已渲染的 Facebook 评论；管理页面的 Graph API 桥接读取视频评论。两者都使用 type: "facebook"、标准聊天字段，并且没有 event 用于普通评论。API 桥接还包含可选的 platform: "facebook".
API 桥接使用 userid 用于可用时的作者 ID， timestamp 用于以 Unix 毫秒表示的有效创建时间，以及 contentimg 用于 API 提供的 HTTP(S) 附件图像。仅含图像的评论可能有空的 chatmessage. textonly 仅适用于消息正文：为 true 时使用原始文本，为 false 时使用经过转义的 HTML。
API 评论上下文使用 meta.messageId （原生评论 ID）， meta.permalink, meta.videoId，以及 meta.pageId。早期 API 版本使用 meta.commentId，重复的作者/时间字段位于 meta，并在那里传递原始附件。新版本改用标准的作者/时间/媒体字段；这不会增加删除同步支持。
观众数量仅在启用后刷新。API 桥接读取同时在线的 live_views；不会用视频累计观看次数代替，也不会为不可用的计数捏造零值。API 捕获不会从普通评论文本推断 Stars、会员、亮点或回复。
当 Facebook 显示可见的以下内容时，会从渲染的 Live Chat DOM 中捕获 Stars： N sent 标记；它们填充 hasDonation 和 donoValue 按 100 Stars = 1 美元计算，不设置 data.event.
测试时，添加 ssnreplay=1 添加到 Facebook Live URL，以处理刷新后已经可见的聊天行。

事件	触发时机	载荷说明
`viewer_update`	DOM 轮询实时观众徽章；API 桥接在启用时轮询同时在线观众数。	`meta` 整数型观众数量，与其他来源一致。缺失或无法解析的计数会被跳过；实际为零的值有效。
`hasDonation`	在 Live Chat DOM 中渲染的 Facebook Stars。	标准聊天载荷； `hasDonation` 携带可见的 Stars 数量，例如 `100 Stars`，以及 `donoValue` 携带美元值。Stars 不设置 `data.event`.
`highlightColor`	Facebook 渲染可见的 `HIGHLIGHTED` 标签。	使用普通聊天字段和 `highlightColor`；没有 `data.event` 已设置。Stars 仍然使用 `hasDonation`.

Online Church

实现： sources/onlinechurch.js

依赖对公开聊天和媒体标题栏的 DOM 抓取。
观众数量仅在以下情况下刷新： 显示观众数量 或 hype 模式已启用。

事件	触发时机	载荷说明
`message`	新条目出现在以下位置： `#publicchat`.	标准聊天载荷，包含发送者姓名、头像、徽章，以及 DOM 中存在时的可选会员标签。
`viewer_update`	每 10 秒轮询媒体标题栏中的实时在线人数徽章。	`meta` 整数型观众数量；发送 `0` 当徽章缺失或不可读时，用于清除过期计数器。

SharePlay.tv

实现： sources/shareplay.js

桌面 API 实现： ssn_app/resources/shareplay-client.js。SSApp 原生来源使用由 SharePlay 工作人员配置的公共 OAuth 客户端，订阅授权用户自己的频道。

依赖对 SharePlay 频道页面上直播聊天抽屉的 DOM 抓取。
抓取程序连接后，仅发出新插入的聊天行和卡片；现有积压记录会被有意忽略。
桌面 API 来源接收新的 EventSub 事件；断线期间的消息不会重放。聊天将 SharePlay 消息 ID 放入 id ，发送者 ID 放入 userid，但不包含头像或徽章。表情遵循 textonly；当被回复的消息位于会话的 200 条消息缓存中时，回复会填充现有的回复字段。
桌面 API 将已完成的 channel.blitz 事件映射为 raid，聊天中的频道推荐映射为 shoutout，以及 stream.viewers 为 viewer_update （启用观众数或 hype 模式时）。API 频道推荐包含所提供的聊天文本，不包含 DOM 卡片的横幅或按钮元数据。合成的聊天/Blitz 事件保留 meta.is_synthetic: true；观众数更新保留整数形式的 meta.

事件	触发时机	载荷说明
`message`	主聊天信息流内出现新的聊天行。	包含作者、头像、徽章图像和保留 HTML 的表情的标准聊天载荷。串内回复还会填充 `initial`, `reply`，以及 `meta.reply` 当父行仍存在时。
`raid`	SharePlay 将 Blitz 卡片插入直播聊天信息流。	映射为规范的突袭事件。 `meta.cardType` 为 `"blitz"`，可选地带有 `meta.fromLogin` 和 `meta.viewers` 当卡片文本提供它们时。
`shoutout`	SharePlay 将推荐/关注卡片插入聊天信息流。	发出为 `data.event = "shoutout"`。卡片横幅图片通过以下字段转发： `contentimg`，而 `meta.cardType` 和 `meta.action` 保留卡片标签/按钮文本。
`viewer_update`	每 10 秒轮询可见标题栏中的观众徽章。	`meta` 整数型观众数量；仅在以下情况下发出：显示观众数量或 hype 模式已启用，并发送 `0` 如果徽章变得不可读，则清除过期计数器。

Streamplace

实现： sources/streamplace.js

读取 Streamplace 由 React 渲染的直播页面，并在连接时跳过可见的聊天积压记录。
转发样式的消息，例如 Name (Discord): message 被标准化为转发的发送者姓名。

事件	触发时机	载荷说明
`message`	连接后出现新的 Streamplace 聊天行。	带有以下字段的标准聊天载荷： `nameColor`, `chatbadges`、保留 HTML 的链接，以及回复字段 `initial`, `reply`，以及 `meta.reply` 可见时。
`viewer_update`	启用观众数量捕获或 hype 模式时，标题栏观众徽章发生变化。	`meta` 整数型观众数量。

WorldsWave

实现： sources/worldswave.js

支持 WorldsWave 直播页面和仅聊天 URL，例如 https://worldswave.com/kn_livecmd.php?cmd=viewStream&streamId=STREAM_ID&chatonly=1.
使用稳定的 data-ww-*/ww-chat-* 标记，在可用时使用，同时为仅聊天页面和旧版布局保留旧版 kontackt 选择器。
捕获连接时会跳过已有聊天历史；请用新消息测试。
观众数量需要 显示观众数量 或 hype 模式。尚未实现专用礼物/打赏事件和回发。渲染的行仍可通过以下字段提供打赏标签： data-ww-donation.

事件	触发时机	载荷说明
`message`	出现一条新渲染的 WorldsWave 聊天行。	带有以下字段的标准聊天载荷： `type: "worldswave"`、发送者名称、头像、可选用户 ID、名称颜色、徽章、管理员状态、会员状态、打赏值、附件和频道标识。稳定的 WorldsWave 消息 ID 公开为 `meta.messageId` 并在同时显示的预览/完整聊天面板之间去重。禁用纯文本模式时，内嵌消息图像仍会经过净化。
`viewer_update`	启用观众数量捕获或 hype 模式时，可见的实时观众总数发生变化。	`meta` 是整数型观众数量。稳定的 `data-ww-viewer-count` 值优先；缩写形式的旧版值，例如 `1.2K` 作为回退方式进行标准化。

FLEX TV

实现： sources/flextv.js

读取以下位置渲染的聊天面板： https://www.flextv.co.kr/channels/*/live 页面。
聊天面板必须可见。来源连接时会跳过现有聊天历史记录，因此请使用新的聊天行进行测试。
此来源尚未记录观众数量、打赏或回发路径。

事件	触发时机	载荷说明
`message`	新出现的 FLEX TV `.chat-item` 行出现在直播聊天信息流中。	带有以下字段的标准聊天载荷： `type: "flextv"`, `chatname`, `chatmessage`, `nameColor`，徽章图片位于 `chatbadges`，以及位于以下位置的 FLEX 会员详情： `meta` 当由以下来源提供时： `data-member`.

Seal Team Sloth

实现： sources/sealteamsloth.js

读取频道聊天 https://sealteamsloth.com/USERNAME；添加 ?popout=1 用于弹出聊天。
观众数量需要 显示观众数量 或 hype 模式。

事件	触发时机	载荷说明
`message`	出现一条新渲染的 Seal Team Sloth 聊天行。	带有以下字段的标准聊天载荷： `type: "sealteamsloth"`、发送者名称、头像和消息内容。
`viewer_update`	启用观众数量捕获或 hype 模式时，可见的实时观众总数发生变化。	`meta` 是整数型观众数量；缩写值，例如 `1.2K` 会进行标准化。

MeetMe — DOM 和 WebSocket 捕获

实现： sources/meetme.js

读取 MeetMe 在以下位置渲染的直播聊天 DOM： app.meetme.com/live/view/... 页面，以及在 api.gateway.meetme-live.com/web-live/... iframe.
iframe websocket 可用时， wss://video-live.meetme.com/ 帧会在 DOM 回退之前解析，以捕获更丰富的直播事件。
hideevents 抑制非打赏事件；MeetMe 礼物和钻石打赏仍会填充打赏字段。 capturejoinedevent 启用加入/重新加入通知。行为者专属的 liked 事件使用共享后台路由，由以下设置控制： capturelikeevent；汇总的 reaction 效果仍明确以 Reactions Overlay 为目标。
观众数量优先使用可见的 MeetMe 标题栏计数，仅在 DOM 计数不可用时回退到 websocket 总数。计数会在变化时发出，并且在以下条件成立时约每 30 秒重复发出最新计数： showviewercount/hypemode 已启用；关注者总数仅在变化时发出，且频率限制为约 60 秒一次。

事件	触发时机	载荷说明
`message`	新 `SNSChatMessage` websocket 帧到达，或新的 `ChatMessage_` DOM 行出现在 `ChatHistoryContainer_`.	标准聊天载荷，包含发送者姓名、头像、消息 HTML/文本和徽章图像/文本。DOM 行详情采用扁平结构，位于 `meta` 键，包括 `messageId`, `roomId`, `level`, `levelColor`, `badgeLabels`, `badgeSrcs`, `badgeClasses`, `isBouncer`, `isTopStreamer`, `isBestOfTheWeek`, `rank`，以及 `rowClassName`。WebSocket 载荷设置 `meta.source = "websocket"`.
`joined` / `rejoined` / `left`	`SNSChatParticipant` websocket 创建、更新或删除帧到达，或 MeetMe 渲染 DOM `join-cell` 行。加入/重新加入通知需要捕获“joined”直播事件.	当 MeetMe 提供行为人的名称/头像时，会发出带有这些信息的聊天样式系统通知。 `meta.isNewViewer`, `meta.viewerLevelId`, `meta.isBouncer`，以及 `meta.isSubscriber` 保留参与者状态。
`new_follower`	MeetMe 渲染 DOM 收藏/关注行，例如 `Favorited`.	使用共享的关注者事件词汇。 `chatname` 是行为者， `chatimg` 是可用时检测到的个人资料照片，而扁平的 `meta.favoriteText`/`meta.targetName` 保留原始行详情。
`gift`	`SNSGiftMessage` websocket 帧到达，或 MeetMe 在聊天行中渲染礼物图像。	`hasDonation` 携带可见的礼物标签或钻石值， `contentimg` 提供时携带礼物图像，以及如下扁平键： `meta.giftName`, `meta.giftCount`, `meta.amount`，以及 `meta.currency` 保留结构化详情。 `gift` 事件保留给实际的礼物帧/行；打赏渲染仍应依据 `hasDonation`.
`donation`	`SNSDiamond` websocket 帧提供钻石活动。	专用 diamond 帧被视为打赏事件。 `hasDonation` 格式化为钻石，以供共享美元换算，而 `meta.amount`/`meta.currency` 保持扁平结构，以供自动化使用。
`liked` / `reaction`	`SNSLike` websocket 帧到达。	特定用户的点赞使用相同的 `liked` 词汇以及与 TikTok 相同的集中式后台路由。汇总/匿名点赞总数仅作为以下内容发送到回应目标： `reaction`，带有扁平的 `meta.reactionType`, `meta.totalLikes`，以及 `meta.subscriberLikes`。区别在于事件含义，而不是是否匿名： `capturelikeevent` 仅控制单个 `liked`/`like` 事件。
`follower_update`	`SNSVideo` websocket 元数据提供关注者总数。	`meta` 是关注者整数，与共享计数器事件约定一致。
`guest_update`	`SNSVideoGuestBroadcast` 创建/更新帧到达。	用于嘉宾/直播联播状态的仅元数据事件。扁平的 `meta` 键包括 `status`, `position`, `totalGuests`, `isMuted`, `guestBroadcastId`, `videoViewerId`，以及 `broadcastId`.
`viewer_update`	可见的标题栏观众徽章发生变化，或者 `SNSVideo` 徽章不可用时，websocket 元数据提供观众总数；启用期间，未变化的总数约每 30 秒重复一次。	`meta` 整数型观众数量；仅在启用观众数量捕获或 hype 模式时发出。

Velora

实现： sources/velora.js 和 sources/websocket/velora.js

标准模式读取可见的聊天 DOM；WebSocket 模式通过 OAuth 使用 Velora Events API。
支持的标准模式 URL 包括 https://velora.tv/*, https://velora.tv/dashboard/stream/popout?panels=chat%2Cactivity&channel=CHANNEL&layout=vertical，以及 https://velora.tv/dashboard/stream/popout/CHANNEL/obs-chat.
DOM 或 Events API 提供 Volts 和频道点数样式卡片时，会将其作为事件载荷发出。

事件	触发时机	载荷说明
`message`	出现新的 Velora 聊天行或收到 Events API 聊天消息。	标准聊天载荷，在非纯文本模式下保留徽章、作者颜色、链接和表情。
`volts`	Velora Volts 卡片或 `channel.volts` 收到 Events API 载荷。	`hasDonation` 携带显示的 Volts 金额；DOM 捕获包含 `meta.source = "dom"`.
`channel_points`	Velora 频道点数/兑换卡片或 `channel.channel_points_redemption` 收到 Events API 载荷。	`chatmessage` 携带兑换消息或奖励标题； `meta.rewardTitle` 可用时标识奖励。
`subscription`	可见的 Velora 活动行表明某用户成为了频道会员/订阅者。	`membership` 携带可见的会员标签。
`viewer_update`	启用观众数量捕获或 hype 模式时，可见的观众数量发生变化。	`meta` 整数型观众数量。

Razo - Popout Chat Capture

实现： sources/razo.js

打开 https://razo.tv/dashboard/chat-popout while signed in, or use https://razo.tv/overlay/chat/USERNAME for read-only capture.
Captures ordinary Razo chat, including loaded history, once per native message ID during the page session. Messages received while capture is off are skipped.
Chat uses type: "razo" 和 platform: "razo", with display name, username, name color, image badges and message text or emotes. Text-only mode uses emote alt text.
Visible “Message removed” updates remove the corresponding captured message. Paid cards, activity notices, private staff/bot notices and imported multichat rows are excluded; use Razo for those features.

Parti — 个人资料 / 弹出聊天捕获

实现： sources/parti.js

支持如下个人资料 URL： https://parti.com/USERNAME 以及如下弹出窗口 URL： https://parti.com/popout-chat?id=USER_ID.
启用观众数量捕获或 hype 模式时，观众数量使用 Parti 的直播心跳端点。

事件	触发时机	载荷说明
`message`	可见的 Parti 聊天行出现在个人资料或弹出聊天流中。	标准聊天载荷； `nameColor` 保留 Parti 渲染的作者颜色和 `chatmessage` 保留内嵌内容，除非启用了纯文本模式。
`donation`	可见的 Parti 打赏行表明某用户打赏了一笔金额。	`hasDonation` 携带显示的金额， `meta.amount`/`meta.currency` 可解析时会填充， `meta.amountText` 保留原始金额文本，而 `donoValue` 针对美元打赏设置。
`viewer_update`	Parti 心跳返回实时观众数量。	`meta` 是整数型观众数量；页面为每个来源窗口复用一个心跳令牌，以避免虚增计数。

CHZZK - 弹出聊天捕获

实现： sources/chzzk.js

支持 https://chzzk.naver.com/live/*/chat 和 https://chzzk.naver.com/iframe/live/*/chat.
启用观众数量捕获或 hype 模式时，观众数量使用 CHZZK 的直播状态轮询端点。

事件	触发时机	载荷说明
`message`	可见的 CHZZK 聊天行出现在弹出聊天流中。	带有以下字段的标准聊天载荷： `type: "chzzk"`, `nameColor`，徽章图片 URL 位于 `chatbadges`，以及位于以下字段中的已渲染表情： `chatmessage` 除非启用了纯文本模式。
聊天，带有 `hasDonation`	可见的 CHZZK 奶酪打赏行出现在聊天中。	`hasDonation` 携带显示的奶酪数量。这些行不设置 `data.event`.
`viewer_update`	直播状态轮询返回观众数量。	`meta` 是整数型观众数量。

Rumble — 标准 DOM 捕获

实现： sources/rumble.js

需要经过身份验证的会话 Cookie，以便 service.php 观众 API 响应。
渲染的 Rant 行提供 hasDonation；入站 raid 卡片提供 event: "raid"。此 DOM 来源不会发出 API 桥接的订阅者/关注者事件 feed。

事件	触发时机	载荷说明
`message`	可见的 Rumble 聊天行出现在页面或弹出聊天中。	标准聊天载荷； `chatmessage` 在页面渲染后保留 Rumble 表情图像 HTML，除非启用了纯文本模式。
`viewer_update`	调用 Rumble 的 `video.watching-now` 服务，每 30 秒一次。	`meta` 整数型观众数量；使用 `credentials: 'include'` 以复用会话 Cookie。
聊天，带有 `hasDonation`	可见的 Rant 行包含价格。	`hasDonation` 保留渲染的价格；不会添加打赏事件标记。
`raid`	聊天中出现入站 raid 卡片。	使用可见的突袭消息和可选卡片图像，位于 `contentimg`.

Rumble — Websocket/API URL

实现： sources/websocket/rumble.js

需要创作者拥有的 Live Stream API URL，获取位置为 https://rumble.com/account/livestream-api。Rumble 文档说明此 URL 包含直播密钥，无需单独认证，并且只能与受信任的第三方分享。
只读传输。公开的 Rumble Live Stream API 文档没有描述官方聊天发送端点，因此此来源会将消息/事件转发到 Social Stream，但不会将聊天发回 Rumble。
livestreams[].chat 仅在所选直播正在进行时填充。使用 ?streamId=... 在 API 提供多个直播时固定某个直播；无效 ID 现在会失败，而不是静默回退到其他直播。
该页面还会解析 https://rumble.com/chat/popup/<livestreams[].id> 这样您可以直接打开普通注入式弹出聊天，而无需先加载主播的 /live 页面。

事件	触发时机	载荷说明
`message`	官方 API 解析以下内容后，Rumble 的 SSE 聊天流会收到新条目： `livestreams[].id`；回退到 `livestreams[].chat.recent_messages`.	标准聊天载荷。 `meta.source` 为 `rumble_sse` 当 SSE 聊天流可用并包含来自以下位置的头像 URL 时： `users[].image.1`；否则回退到 `live_stream_api` 不带头像。当弹出窗口表情目录可用时， `chatmessage` 将 Rumble 短代码表情渲染为图像 HTML，并且 `meta.plainText` 保留原始短代码文本。
`donation`	新的 rant 条目出现在 `livestreams[].chat.recent_rants`.	`hasDonation` 携带美元格式的金额； `meta` 包含 `amount_cents`, `amount_dollars`，以及 `expiresOn`.
`new_follower`	新条目出现在 `followers.recent_followers`.	带有以下字段的系统事件： `chatname` 设为关注者用户名，并将时间戳放在 `meta.followedOn`.
`new_subscriber`	新条目出现在 `subscribers.recent_subscribers`.	`membership` 设为 `SUBSCRIBER`; `subtitle` 对应 Rumble 提供时所记录的美元金额。
`subscription_gift`	新条目出现在 `gifted_subs.recent_gifted_subs`.	`chatname` 是赠送者， `hasDonation` 变为 `N Gifted`，以及 `meta` 包含 `totalGifted`, `remainingGifts`, `giftType`，以及 `videoId`.
`follower_update`	每当所选关注者计数器变化时。	`meta` 整数型关注者数量。默认为 `followers.num_followers`；带有 `?followerMode=total`，使用 `followers.num_followers_total` 当 Rumble 提供它时。
`subscriber_update`	每当 `subscribers.num_subscribers` 发生变化。	`meta` 整数型订阅者数量。
`stream_online` / `stream_offline`	所选直播在直播中和离线状态之间切换时。	`meta` 包含经过净化的直播字段子集（`id`, `title`, `createdOn`、类别标签、赞/踩，以及观众总数）。敏感值，例如 `stream_key` 被有意排除，不会转发。
`viewer_update`	每当 `livestreams[].watching_now` 针对所选直播发生变化。	`meta` 整数型同时在线观众数量；发出 `0` 当所选直播离线时，用于清除过期计数器。

此传输方式适用于您拥有或管理的频道。由于 API URL 包含直播密钥，请勿将其暴露在叠加层、日志、截图或共享浏览器配置文件中。官方 API 解析直播 ID 后，聊天头像来自 Rumble 的 SSE 聊天流；此传输方式不会抓取 Rumble 页面来获取头像。

YouNow — DOM 捕获

实现： sources/younow.js

读取渲染的直播聊天 DOM，并发出带有以下字段的标准聊天载荷： type: "younow".
观众活动行，例如 is watching, I became a fan!，以及 invited N fans to this broadcast. 会标记为 event: true 以便事件筛选器可以对其进行路由。

事件	触发时机	载荷说明
`message`	观众直播聊天中出现新的聊天行。	标准聊天载荷；粉丝/观众活动行会设置 `event: true`.
`viewer_update`	可见的观众面板计数发生变化，同时 `showviewercount`/`hypemode` 已启用。	`meta` 整数型观众数量；发出 `0` 当计数器消失时。

Favorited Studio - DOM 捕获

实现： sources/favorited.js

读取渲染的直播聊天 DOM，并发出带有以下字段的标准聊天载荷： type: "favorited".

事件	触发时机	载荷说明
`message`	出现新的聊天行。	标准聊天载荷。
`viewer_update`	直播观众标签页计数发生变化，同时 `showviewercount`/`hypemode` 已启用。	`meta` 从以下位置读取的整数型观众数量： `content-live-viewers` 标签页。

BEAM - DOM 捕获

实现： sources/beamstream.js

读取渲染的直播聊天 DOM，并发出带有以下字段的标准聊天载荷： type: "beamstream".

事件	触发时机	载荷说明
`message`	出现新的聊天行。	带有纯文本字段的标准聊天载荷： `chatname`，头像 URL 位于 `chatimg`，以及位于以下字段中的图片 URL 或 SVG 徽章对象： `chatbadges`。Beam 捕获页面隐藏的字段保持为空。Beam 原生个人资料链接不被视为外部转发来源。 `contentimg` 提供时可能携带内嵌 video/webm 附件。
`viewer_update`	观众计数器元素发生变化，且 `showviewercount`/`hypemode` 已启用。	`meta` 整数型观众数量；仅当聊天页面提供观众计数器时发出。

斯塔维奥斯

实现： sources/starvios.js

捕获新呈现的聊天行 https://starvios.com/popout/chat/USERNAME 带有 type: "starvios"，简单的发件人姓名、名称颜色以及文本或内联表情 textonly.
付费聊天行保留显示的金额 hasDonation （例如， 100 Starvies）。不提供美元兑换或捐赠事件。
现有行和在最初的 1.5 秒历史记录稳定期内渲染的行将被跳过。单独的固定卡片、回复预览和订阅/突袭通知不包括在内。弹出窗口不提供经过验证的观看者数量。
使用标准 focusChat 当存在可见的、可编辑的输入时回复挂钩。经过身份验证的发送仍未得到验证。

机器人流媒体

打开 https://robotstreamer.com/chat.html?c=CHANNEL_ID 并保持选择“流聊天”以进行仅频道捕获。每条新消息（包括按同一作者分组的消息）都使用 platform/type: "robotstreamer"，纯文本的 chatname, userid, chatimg, chatbadges，以及 nameColor。消息体保留安全的内嵌图像； textonlymode 使用文字文本和图像标签。初始历史记录和系统通知被排除在外。 RobotStreamer 删除内容不会被转发；如果需要，请删除 SSN 坞站中的审核消息。

Castyr - DOM 捕获

实现： sources/castyr.js

从以下位置读取新渲染的聊天行： https://castyr.live/homebeta/popout-chat/* 并发出带有以下字段的标准聊天载荷： type: "castyr".
来源连接时会跳过已有聊天历史。

事件	触发时机	载荷说明
`message`	一个新的 `.chat-message` 行出现。	标准聊天载荷，包含发送者姓名、渲染的消息内容，以及来源提供时的姓名颜色。
`viewer_update`	可见的活跃聊天计数发生变化，同时 `showviewercount`/`hypemode` 已启用。	`meta` 是从 Castyr 带标题的活跃聊天元素中读取的整数计数。

SOOP — 播放器 DOM 捕获

实现： sources/sooplive.js。支持统一的 play.sooplive.com 播放器和旧版 play.sooplive.co.kr URL。提供旧版全局聊天布局时，仍会识别它。

公开聊天发出 type/platform: "sooplive"，纯文本的 chatname/userid, nameColor，以及经过清理的 chatmessage。排除现有行、重复消息 ID、翻译副本和私人私信。表情会转换为安全图片，或在纯文本模式下转换为替代文本。

带有 showviewercount 或 hypemode 启用时， viewer_update 携带整数 meta 来自播放器的 #nAllViewer。仅聊天的弹出窗口可能不提供此计数。SSApp 打开独立弹出窗口时会使用完整播放器，因为当前 SOOP 弹出窗口依赖其打开者。

Gosh - 频道聊天捕获

实现： sources/gosh.js。打开 https://gosh.com/USERNAME 并让聊天可见，或将该 URL 粘贴到 SSApp 的 Add other source（添加其他来源）。无需弹出聊天窗口。

新的聊天行发出 type/platform: "gosh"，纯文本的 chatname, nameColor，以及经过清理的 chatmessage。内联图片和 GIF 保留安全的 HTTP(S) URL。使用 textonlymode，图片转换为替代文本或 [image] 当没有替代文本时。头像、徽章、打赏和会员在捕获行中缺失时保持为空。

让虚拟化聊天列表保持滚动到最新消息。排除现有历史记录、重新渲染的行和无作者的系统通知。渲染索引仅供内部使用，不会作为原生消息 ID 发出。不会推断关注、打赏、观众数量或管理事件。

Livacha — 聊天室捕获

实现： sources/livacha.js。打开 https://livacha.com/chat/ROOM 并让聊天可见，或将聊天室 URL 粘贴到 SSApp 的 Add other source（添加其他来源）。

新的聊天行发出 type/platform: "livacha"，纯文本的 chatname, chatimg, nameColor，以及经过清理的 chatmessage。相对头像和内联图片 URL 会转换为绝对 HTTP(S) URL。段落、换行和列表会展平成一条聊天消息。使用 textonlymode，图片转换为替代文本或 [image].

消息 ID 在内部用于避免重复捕获编辑内容和重新挂载的行。会跳过初始历史记录和前置加载的旧消息；时间戳和回应菜单不属于捕获正文。不会推断打赏、会员、管理或观众数量事件。

Chatango - 群聊

打开 https://ROOM.chatango.com/，或嵌入 Chatango 房间的页面。新行发出标准聊天 type/platform: "chatango"，纯文本的 chatname, nameColor, chatmessage，以及 chatimg 当可用时。内嵌图像使用 HTTP(S) URL；纯文本模式使用其替代文本或 [image]。捕获附加时已显示的行以及向后滚动时预先添加的旧消息将被跳过。

Vaughn Live - 频道聊天捕获

实现： sources/vaughn.js。打开 https://vaughn.live/USERNAME 聊天可见，或将频道 URL 粘贴到桌面应用程序的添加其他源中。

每个新消息正文都会发出标准聊天 type/platform: "vaughn"，纯文本的 chatname, chatmessage，以及团体头像 chatimg, nameColor和图像/SVG chatbadges 当存在时。紧凑聊天会读取消息前面的名称。表情使用其显示的图像 URL，或其触发/替代文本 textonlymode.

内部跟踪消息 ID 和元素，以避免在分组消息到达、确认后 ID 更改或再次呈现行时出现重复。当初始加载覆盖可见时呈现的现有消息和历史记录将被跳过。时间戳、消息工具和链接预览卡不包含在消息内容中。

Stream.space — 实验性 DOM 捕获

实现： sources/streamspace.js。仅匹配 https://beta.stream.space/chat-popup.php?channel=USERNAME 和等效的 https://stream.space 弹出窗口。

新渲染的聊天行发出 type: "streamspace", platform: "streamspace"，纯文本的 chatname/userid, chatmessage，头像 chatimg，以图片呈现的等级 chatbadges，以及 nameColor。内联表情会重建为安全图片，或在以下情况下使用其替代文本： textonlymode 已启用。排除现有历史记录、欢迎通知、回复预览和置顶重复项。

viewer_update 携带整数 meta 读取自 #popupViewersNum 当 showviewercount 或 hypemode 已启用。不会推断打赏、会员或管理事件。

实验性：检查期间 beta 弹出窗口一直停留在 Loading。SSApp 加载了弹出窗口并捕获到观众更新，但实时聊天交付和生产版弹出窗口仍未验证。SSN 无法捕获网站未渲染的消息。

w.tv 和 Prime — DOM 捕获

实现： sources/wtv.js 在 https://w.tv/USERNAME/chat 和 sources/prime.js 在 https://prime.gs/USERNAME?chat_popout=1.

新的聊天行使用 type/platform 的 wtv 或 prime，纯文本的 chatname, nameColor，以及经过清理的 chatmessage。内联表情会转换为安全图片，或在纯文本模式下转换为替代文本。Prime 还包括该行的 userid 并支持已登录的个人资料链接及未登录的用户名标签。当已验证的行结构中不存在头像和徽章时，这些字段保持为空。

不包含初始历史记录、置顶卡片和回复预览。w.tv 使用虚拟化聊天列表：请保持滚动到最新消息，以便捕获。其 DOM 测试 ID 是渲染索引，并非原生消息 ID。Prime 会跳过在初始消息上方加载的旧历史记录和被忽略用户的占位内容。

这两种弹出窗口都不提供经过验证的直播观众数量，因此这些适配器不会发出观众更新，也不会推断打赏、订阅或管理事件。

Goodgame、Pilled、Owncast、Picarto 和 Piczel 观看者计数

启用 显示观众数量 或 跟踪活跃聊天用户 (showviewercount 或 hypemode) 收集观看者计数。打开显示查看者的“查看者计数和聊天活动”叠加层也会请求它们。每个源发出 event: "viewer_update" 具有非负整数 meta，在启用捕获时每 30 秒刷新一次。这些是流媒体观看者数量；活跃聊天者单独计数。报告的零有效；失败的请求不会产生零计数。

正常聊天使用源的 type, chatname, chatmessage，以及 textonly 没有查看器事件标记的字段。查看器更新包含 type, event，和整数 meta;背景将它们组合成 viewer_updates 用于叠加。

来源/类型	要捕获的页面	观看者计数和聊天字段
好游戏 `goodgame`	`goodgame.ru/CHANNEL/chat`	串流 `viewers`。聊天行还包含本机 ID 作为字符串 `meta.messageId` 可用时。
起球 `pilled`	`pilled.net/livechat/USERNAME` 或 `pilled.net/comment/TOPIC_ID`	当前直播话题 `topicFacts.liveViews`。专用聊天URL支持在不打开视频页面的情况下进行计数。
Owncast `owncast`	您捕获的 Owcast 流或聊天页面	`viewerCount` 从该服务器的 `/api/status`.
皮卡托 `picarto`	`picarto.tv/chatpopout/CHANNEL/public`	频道 `viewers`.
皮策尔 `piczel`	`piczel.tv/chat/CHANNEL` 或 `piczel.tv/watch/CHANNEL`	匹配流的 `viewers`。加入聊天或登录以显示聊天行；可以在加入之前收集观看者计数。

跨平台事件对齐

使用此表了解类似概念如何在各平台之间映射。在可能的情况下，新来源应与第一列中的通用事件名称保持一致。

概念	YouTube WS	Twitch WS	Kick WS
新会员/订阅者	`sponsorship`	`new_subscriber`	`new_subscriber`
续订/重新订阅	`resub`	`resub`	`resub`
赠送订阅	`giftpurchase`	`subscription_gift`	`subscription_gift`
收到礼物	`giftredemption`	-	-
里程碑	`membermilestone`	-	-
捐款/打赏	`superchat`, `supersticker`, `jeweldonation` 带有 `hasDonation`	`cheer` （bits）	`donation`
新关注者	`new_follower` （轮询）*	`new_follower`	`new_follower`
观众数量	`viewer_update`	`viewer_update`	`viewer_update`
关注者计数	-	`follower_update`	`follower_update`
订阅数量	`subscriber_update`	`subscriber_update`	-
直播状态	`live_chat_ended`	`stream_online`/`stream_offline`	`stream_online`/`stream_offline`
突袭	-	`raid`	-
奖励兑换	-	`reward`	`reward`

一致性说明

YouTube 使用 sponsorship 用于新会员，而 Twitch 和 Kick 使用 new_subscriber。构建跨平台触发器时，可考虑同时检查两者。
resub 保持一致 用于全部三个平台的续订。
礼物事件有所不同： YouTube 使用 giftpurchase/giftredemption，而 Twitch 和 Kick 使用 subscription_gift.
打赏因平台而异： YouTube 使用具体的付费事件名称，例如 superchat, supersticker，以及 jeweldonation 带有 hasDonation；Twitch 有 bits（cheer）；Kick 有打赏（donation).
new_follower 现在保持一致 适用于全部三个平台，但 YouTube 会轮询最近的订阅者，返回的结果可能有延迟或不完整。
点赞和回应使用不同的数据约定： 单个 liked/like 事件会到达 Reactions Overlay，除非被全局筛选，并且仅在以下条件成立时进入主处理管线： capturelikeevent 已启用。可视化或平台原生的 reaction 事件保留生成方定义的路由。汇总的 likes_update 计数器由以下设置单独控制： captureliketotals.

覆盖范围和兼容性限制

本参考描述已实现的载荷，并不保证每个平台都会提供每种事件。空的 hasDonation 在来源中的赋值并不能证明支持打赏。DOM 可见性、账号权限、捕获开关和 API 可用性仍决定收到哪些内容。删除转发因来源而异；不要假定所有来源都支持管理同步。

已跟踪的不一致和空缺

配对/区域	已观察到的不一致 / 空缺	影响
Twitch：标准模式与 Websocket	共享： `reward`, `subscription_gift`, `viewer_update`, `hype_train`，以及需主动启用的 `watch_streak`。仅 Standard： `giftpurchase`, `knock`, `community_highlight`。仅 WebSocket： `new_subscriber`, `resub`, `cheer`, `powerup`, `raid`, `new_follower`, `follower_update`, `subscriber_update`.	`channel_points` 现在是 Twitch 奖励兑换的已弃用旧版别名；新集成应依据 `reward`.
Kick：标准模式与 Websocket	标准模式发出轻量标记（`gift`, `reward`，布尔值 `true`, `viewer_update`）。WebSocket 增加官方关注、订阅、礼物、奖励兑换、KICKs、管理和直播状态事件。它保留对旧版 `raid` 载荷，但 Kick 目前不提供官方 raid/host 订阅。	Websocket 模式更丰富；切换时，应检查围绕仅标准模式事件名称构建的自动化。不要要求 Kick 突袭事件。
YouTube：标准模式与 Websocket	共享： `superchat`, `supersticker`, `jeweldonation`, `sponsorship`, `resub`, `giftpurchase`, `giftredemption`, `viewer_update`。仅 Standard： `thankyou`, `redirect`。仅 WebSocket： `membermilestone`, `new_follower`, `subscriber_update`, `view_update`, `likes_update` （需主动启用）。	两者的核心会员/事件名称保持一致；Super Chat、Super Sticker 和 Jewels 使用 `hasDonation`，而会员礼物的购买/兑换不使用。
所有界面	许多来源会填充 `hasDonation` 不设置 `data.event`.	这是正确的；打赏渲染应依据 `hasDonation`，带有 `data.event` 保留给系统/事件语义。

来源专属别名和旧版名称

这些映射专用于列出的来源/上下文，不是全局替换。使用方对别名的支持因页面而异。当前 TikTok DOM 和 TikFinity 来源仍然发出 followed；Velora 使用 subscription 和 channel_points，Streamlabs 则使用 subscription。接受当前来源约定及其相关旧版别名，而不是重命名每个匹配的事件。

别名 / 旧版名称	规范替代项	上下文
`subscription`	`new_subscriber`	Twitch/Kick 新订阅
`subgift`	`subscription_gift`	Twitch 赠送订阅
`membership`	`sponsorship`	YouTube 新会员（通用）
`new_member`	`sponsorship`	YouTube 新会员
`new_membership`	`sponsorship`	YouTube 新会员
`newmember`	`sponsorship`	YouTube 新会员
`new-membership`	`sponsorship`	YouTube DOM 抓取程序（连字符变体）
`upgraded_membership`	`resub`	YouTube 等级升级
`upgraded-membership`	`resub`	YouTube DOM 抓取程序（连字符变体）
`membership_upgrade`	`resub`	YouTube 等级升级
`membership_milestone`	`membermilestone`	YouTube 里程碑聊天
`member_milestone`	`membermilestone`	YouTube 里程碑聊天（下划线变体）
`gift_membership`	`giftpurchase`	YouTube 礼物套装
`membership_gift`	`giftpurchase`	YouTube 礼物套装
`giftmemberships`	`giftpurchase`	YouTube 礼物套装（复数变体）
`gifted_membership`	`giftredemption`	收到 YouTube 礼物
`gifted_memberships`	`giftpurchase`	YouTube 礼物套装（复数变体）
`community_gift`	`giftpurchase`	社区赠礼包
`channel_points`	`reward`	Twitch websocket 奖励兑换（旧版别名）
`followed`	`new_follower`	当前 TikTok DOM/TikFinity 输出；组合 TikTok 捕获模式时应接受这两个名称。

使用本参考

添加新事件时，复用现有词汇（subscription_gift, viewer_update等）。如确实无法避免差异，请在此记录并说明原因。
保持 data.meta 保持可预测：优先使用扁平键，绝不将混合数据塞入字符串，并始终包含单位（currency, bits, duration).
更改载荷时同步更新本页；仅在共享开发规则变化时更新代理说明。
验证载荷更改时，同时检查发出载荷的来源和使用载荷的叠加层或 Event Flow 触发器。
是否捕获取决于来源支持和设置。要在停靠面板或精选叠加层中隐藏带事件标记的行，请添加 &hideevents 或 &hideallevents。要隐藏所选事件，请使用 &filterevents=subscription_gift,new_follower,gifted.
对于 YouTube、Twitch 和 Kick，启用 WebSocket 模式 以获得最广泛的平台专属事件支持。YouTube 的礼物/打赏捕获（包括礼物和 Super Chat）在标准和 WebSocket 模式下均可用；WebSocket 还增加了额外的事件类型。具体支持仍因平台、账号角色和已授予的权限范围而异。

返回顶部

事件叠加显示控件

发送 {"action":"eventOverlayControl","surface":"alerts","board":"default","command":"pause"} 通过现有的目标覆盖控制通道。使用目标 alerts 用于多流警报框或目标 dock 有表面 events 用于活动源/事件。该板必须与覆盖层匹配 board URL 选项（默认值： default).

堆栈和提要接受 pause, resume, pin, unpin, remove 和 clear。警报还接受 skip, mute, unmute 和 replay。 Pin 切换最新的可见行；删除将其删除。这些是显示控件，而不是传入流事件，并且不得作为捐赠或事件操作提交。发送的命令并不表明 OBS 正在显示覆盖。

请参阅事件叠加指南用于历史记录、过滤器和受众设置。

变现叠加层

NinjaBacker 打赏使用 platform: "ninjabacker", type: "ninjabacker", chatname，纯文本的 chatmessage, textonly: true、带有来源前缀的 id，格式化后的 hasDonation，以及数字形式的 donoValue。它们是普通打赏样式行，没有 event 覆盖值。 meta.ninjabacker 包含 ISO currency 和主货币单位的 amount。匿名打赏使用显示名称 Anonymous。来源使用实时 SSE（不重放），或 SSN API 上需主动启用的已签名 webhook 接收器（队列交付最长七天）。可靠交付使用稳定的 ninjabacker:delivery:DELIVERY_ID ID。两种模式都不会接收退款/争议冲正。接收端凭据和签名密钥绝不会进入事件载荷。由调用方控制的 callbackId 值不是付款身份，也不会被转发。仪表板测试打赏排除在打赏行之外。它们发出 event: "monetization_test" 带有 meta.ninjabackerTest 包含 id 和 at（Unix 毫秒），仅用于专用预览提醒。

event: "monetization_update" 是来自以下位置的仅元数据快照： type/platform: "socialstream". meta.monetization.wishlist 包含 enabled、qr、position、rank、total、公开的 url，以及当前项目（name、amount、currency、image、公开的 url）或 null。 meta.monetization.ninja 包含 enabled、qr、position、username 和公开的打赏 url。绝不包含私有 Tip ID。 meta.monetization.ebay 包含 enabled、qr、position、display（cycle/cheapest/first）、seconds、可选启用的公告设置和公开项目。每个项目有 id、name、amount、currency、image、url、auction、startingBid、endsAt、available、bought 和 updatedAt。时间为 Unix 毫秒。不包含卖家凭据或买家身份。

主播确认的心愿单购买还包括 meta.wishlistPurchase 带有 id、name、可选的 supporter 和 at（Unix 毫秒）。这是主持人确认，并非 Amazon 付款通知，也不计为货币打赏。叠加层应对其 id 去重，并忽略旧的购买通知。

Shopify 已付款订单

可选的带签名 Shopify 接收端发出 platform/type: "shopify" 和 event: "purchase" 仅用于 orders/paid 带有 financial_status: "paid"、正数总额， test: false、未取消，且带有当前的已签名请求体更新时间戳。测试、未付款、过期、取消和退款通知不会发出购买操作。不会推断赠礼意图。

chatname 为 Anonymous；排除客户字段、私有备注和订单 URL。 chatmessage 是纯文本，带有 textonly: true; subtitle 保存最多三个公开商品标题。 meta.commerce 包含 orderTotal 和 currency 以商店货币计，另加 quantity 当已知完整有效的数量时。接收者和实物/数字用途保持未设置。没有 hasDonation 或 donoValue 已设置。 id 是具有 Shopify 前缀、以商店/订单为范围的稳定不透明哈希；它不是原始订单标识符。

购买使用现有的活动、multi-alerts Purchase 类别和 Event Flow 路径。商品推广使用现有的 meta.monetization.commerce 目录。导入商品或将其推广标签设为 Gift 不会生成购买或礼物事件。 Shopify 设置和交付限制.

礼物和商业交易

使用 event: "gift" 用于礼物， giftcontribution 用于为礼物提供付费支持， giftfunded 用于筹款完成，以及 purchase 用于商品销售。这些名称独立于提供商，也不取决于商品是实物还是数字商品。将旧版的 giftpurchase 用于赠送会员的事件；Throne 以前错误地使用该名称，现在发出 gift。现有的会员事件生成方保持不变。自定义 Throne 事件名称筛选器应改用 gift；打赏筛选器无需更改。

hasDonation 仍为付费支持的兼容信号，带有 donoValue 保存所提供或估算的美元值。礼物和贡献保留这些字段。筹款完成会省略两者，避免重复计算贡献。普通商品销售默认省略它们，保持 eBay 的数据约定。不要根据商店、心愿单 URL 或实物商品推断赠礼意图：为买家或其他收件人购买仍然属于销售，除非来源明确标识为向创作者赠礼。

可选的共享 meta.commerce 字段为 recipient （creator、buyer、other）， itemType （physical、digital、service）， quantity （正数商品数量）， currency （ISO 货币）， goalAmount （以主要货币单位表示的筹款目标，绝不是新增收入），以及 orderTotal （已知的主要货币单位已付款订单总额；属于商业交易，而非打赏收入）。省略未知详情。商品名称保留在 subtitle，图片位于 contentimg，以及位于以下字段中的支持者文本： chatmessage。现有提供商元数据仍然可用。Throne 提供接收者和货币，并在完成时提供 goalAmount；eBay 提供数量。两者都不会猜测商品类型，也不会公开接收者的私人信息。

即使没有支持者文本，活动信息流也会显示这些事件。Multi-alerts 对礼物和贡献使用打赏展示方式，包括一个不含货币价值的独立 Gift Fully Funded 通知。购买有单独的 Purchase 类别，默认启用，带有 purchasestyle, purchasesound, purchaseaccent，以及 disablepurchases URL 控件。购买提醒不会改变打赏总额。

Event Flow 在 Event Type 和 Other Event 触发器中提供这些事件名称。打赏触发器仍检查 hasDonation；Gift Sub 触发器保留会员语义。Compare Property 接受嵌套路径，例如 meta.commerce.recipient。操作模板接受 {meta.commerce.quantity} 和 {meta.commerce.currency}，以及现有的 {donation}, {subtitle}，以及 {meta}。嵌套路径区分大小写，缺失值显示为空，并禁止遍历原型。

Patreon new pledges

Standard Patreon chat uses a patreon:chat:-prefixed message ID scoped to the chat, so separate messages with identical text remain distinct when duplicate filtering is enabled. When viewer counts are enabled and the page exposes its online-viewer counter, the source emits viewer_update with a numeric meta count.

The signed Patreon receiver maps members:pledge:create 为 type/platform: "patreon" 和 event: "new_subscriber". It requires a campaign/member identity and a current pledge_relationship_start on or after the connection was enabled. Free trials, gifted memberships, declined/former memberships and other event types are excluded.

membership 和 subtitle contain the tier when available; chatname is the supplied name or Anonymous. chatmessage 是纯文本（textonly: true), with a labelled pledge amount only when both amount and campaign currency are supplied. No hasDonation 或 donoValue is set: a new pledge is not a payment receipt. Emails, addresses, notes, raw member IDs and account URLs are excluded.

The stable patreon:-prefixed event ID is derived from campaign, member and pledge-chain start, preserving separate pledges with identical text. Delivery retries reuse that ID. Pending events and retry records are retained for seven days; workflows with irreversible external actions should also guard by event ID against interruption between processing and acknowledgment. Connect Patreon alerts.

创作者商业 webhook 和促销叠加层

Ko-fi 公开 Donation 付款保留 hasDonation 并获得美元 donoValue。订阅付款使用 new_subscriber 或 resub，等级位于 membership。Shop Order 和 Commission 使用 purchase 不带打赏值。私有 Ko-fi 事件仍被排除。表单编码的 JSON 只解码一次；姓名和消息为纯文本。

Buy Me a Coffee donation.created 保留货币支持； extra_purchase.created 和 commission_order.created 变为 purchase. wishlist_payment.created 变为 giftcontribution 仅使用该付款金额； meta.commerce.completed 记录提供商的完成标志，不会再发出一条货币金额行。 membership.started 变为 new_subscriber 等级位于 membership，不再误用 hasDonation 用于等级名称。订阅开始金额不会单独被视为一次付费扣款。测试、已退款、失败和不受支持的更新/生命周期事件不会生成付费提醒。隐藏的支持者备注会被省略。

Fourthwall 支持 ORDER_PLACED（purchase）、GIFT_PURCHASE（gift，接收者为其他人）、DONATION（普通打赏行）和 SUBSCRIPTION_PURCHASED（new_subscriber）。现有订单总额保留 hasDonation 以保持向后兼容，标记为 meta.commerce.legacyDonationValue: true；这是对新商品销售默认规则的明确例外。使用礼品卡的订单会发出没有打赏值的购买提醒：无法可靠地从订单总额推断新的扣款，且礼品卡购买已计入。账单姓名和电子邮件地址不用于公开身份。仪表板测试事件和订单更新不会生成付费提醒。

这些适配器保留现有的转发、机器人操作、Event Flow 和目标路由，并带有 meta.webhookId 去重。它们提供公开姓名、纯文本消息，以及以下字段中的已知商品名称： subtitle，以及 ISO meta.commerce.currency 在适用时与数值型打赏值一起提供。它们不会添加退款记账或新的接收端身份验证；请使用提供商现有配置的 webhook 路由。

meta.monetization.commerce 在 monetization_update 包含 enabled、qr、position、display（first/cycle）、seconds 和公开的 items 数组。每个项目有 name、url、image、可选的 amount（未知时为 null）、currency 和 purpose（shop/gift/support/membership）。这些是主持人输入的推广详情，并非付款凭证。添加或编辑项目不会发出打赏或购买事件。通用叠加层使用 mode=commerce; view=both|showcase|card|alerts 将推广与活动分开。可选的 style、scale、cardevery、cardfor 和 onlytype URL 参数控制展示方式。现有提供商模式还接受 view 和计划控件。请参阅设置指南.

Throne 礼物事件

可选启用的变现集成转发带签名的 Throne 事件，带有 platform 和 type 设为 throne。三者都使用稳定的交付 id，纯文本的 chatname, chatmessage 带有 textonly: true，商品名称位于 subtitle，以及位于以下字段中的可选 HTTPS 缩略图： contentimg.

事件	含义	打赏金额 / 排名
`gift`	一件已购买的礼物	`hasDonation` 以及美元 `donoValue`；+1 礼物排名
`giftcontribution`	对礼物的出资	仅贡献金额；不增加排名
`giftfunded`	一件众筹礼物已完成	否 `hasDonation` 或 `donoValue`，避免重复计算之前的贡献；+1 礼物排名

meta.throne 包含 itemName, creator （公开用户名）， completed, currency 和主货币单位的 amount。对于 giftfunded，金额描述的是目标，而非新增收入。匿名赠礼者仍保持为 Anonymous；已完成的社区赠礼使用 Community。私人支付和配送字段绝不会被转发。

monetization_update 快照还包含 meta.monetization.throne: enabled, username, url, qr, position, rank，以及 gifts。这些快照不包含 webhook URL 或监听凭据。

主播语音命令（桌面预览）

Event Flow 的 当我说…… 触发器接收来自 SSApp 的可信本地麦克风命令。其内部操作上下文使用 chatname: "Host", type: "hostvoice"，识别到的短语位于 chatmessage，以及 textonly: true。这不是平台入站事件，也不是新的聊天传输。通过聊天发送这些字段无法激活语音触发器。

需要更新后的桌面版本、明确启动麦克风，并在测试模式后启用操作。请参阅预览设置和验证状态.

商品展示控件

现有的 monetization_update 快照可能包含 meta.monetization.commerce.live：null 表示已保存的计划，或 {mode: "show" | "hide", url?: "https://...", until: 0 | epochMilliseconds}。Show 匹配已保存的准确商品 URL；找不到商品则不显示卡片。正数 until 到期后恢复已保存的计划；零表示持续到状态更改或 SSN 重启。Hide 抑制促销展示，不抑制付费活动提醒。

commerce.viewerURL 是已发布的只读商店 URL，或空字符串。存在时，推广二维码会链接到该地址。它绝不包含 SSN 会话或发布密钥。商品保留在 commerce.items。显示控制、导入或发布不会发出打赏/购买事件。请参阅商品控件用于 Event Flow 和远程 API。

Event Flow 的 commerceControl 操作等待直接/Chrome 回复（最多八秒）。对于普通事件载荷，它保留事件并添加 meta.commerceControlResult: {success: true, commerce: controlState} 或 {success: false, error: "..."}。对于已有的数字、数组或其他非对象 meta，元数据保持不变，诊断信息返回为 commerceControlResult 改为用于操作结果。失败的控制会停止该链中的后续操作，但不会抑制原始付款事件。超时并不能证明控制未应用；重试 Next 等相对命令之前，请检查状态。成功确认的是本地选择/隐藏/计划状态，绝不表示 OBS 可见或公开页面已同步。

命名的 Stream Deck / API 工作流

此命名工作流触发器创建内部 Event Flow 消息，带有 type: "api", event: "workflow_trigger", chatname: "Stream Deck / API"，空的 chatmessage，以及 textonly: true。其 meta.workflow 对象包含触发器名称和调用方提供的 JSON data 对象。通过如下模板读取值： {meta.workflow.data.minutes}。只会评估明确匹配该触发器的已保存且已启用流程。这不是来自观众/聊天的入站事件，也不会作为聊天广播；将这些字段复制到聊天中不会激活命名触发器。

NinjaChatter 观众试点

实验性的配对扩展连接器发送仅供显示的行，带有 type: socialstreamchat, platform: ninjachatter，以及 textonly: true. meta.ninjachatter 携带 origin: audience，描述性的 provider，以及公开的 room ID。这些行会跳过平台回复、机器人、Event Flow 触发器和积分处理。显示某个提供商并不代表获得授权。旧版 NinjaChatter 来源捕获包括 meta.ninjachatter.room 用于聊天室专属的重复抑制。

Cheer 使用独立且经过认证的领取与结果路径，绝不使用特殊聊天命令。固定预设发出现有的 Actions 叠加层 show_text 消息，持续三秒。收到它表示传输已接受，并不表示已验证 OBS 显示。任何观众载荷都不能选择任意操作。NinjaChatter 默认禁用此试点；在新的私有配对边界通过验证之前，Electron 保留现有转发方式。

商业名额看板和最近销售

现有的 monetization_update 事件（type/platform: socialstream）还包括 meta.monetization.boards。其 board 包含 title, style （名额/队伍）， columns (1–20), visible，以及最多 120 个 spots。每个名额都有一个字符串 id，纯文本的 label, status （available/claimed/revealed）以及 result （纯文本，揭晓前为空）。领取和揭晓是由主播输入的显示状态，并非购买证据或随机分配。

boards.sales 保存最多 100 条最近记录： id, title，可选的 amount （未知时为 null）， currency, quantity, source，以及 at （记录时的 Unix 毫秒时间戳）。 automatic 启用收集， salesVisible 控制显示和 revision 在变化时递增。自动收集仅接受 purchase 来自 Shopify、eBay 卖家、Fourthwall、Ko-fi 和 Buy Me a Coffee 的事件；排除私有/测试事件。它不会将拍卖元数据、打赏、礼物或名额认领视为购买。自动记录不会用订单总额、商品刊登价格或打赏金额代替商品单价。手动记录使用 source: "Host confirmed".

状态会持久保存在此安装实例的私有变现存储中；公开快照不包含交付去重 ID、买家身份和密钥。明确显示的销售记录保留其事件 ID，以供移除。退款需要主持人手动移除。重复购买 ID 会单独记忆（最多 2,000 个），包括清除可见历史记录之后。现有的 getCommerceState 响应包含 commerce.boards; commerceControl 接受以下文档中记录的面板/销售命令：面板指南。手动编辑会广播更新后的状态，但绝不会创建购买事件、打赏总额或付费奖励。主播快照缺失 35 秒后，叠加层会隐藏。

卖家工作流新增内容： commerce.boards.board.id 标识一代面板。手动 saleAdd 可能提供 boardId 和 spotId 以原子方式记录销售并认领该名额；仍在最近历史记录中的重复关联销售会被拒绝。 saleRemove 带有 reopenSpot: true 仅当面板代次仍匹配时释放该名额。公开销售条目省略这些操作员关联字段。可选的 platform 在手动销售记录上保留其来源以供筛选，而 source: "Host confirmed" 标识确认方式。 amount 是该条目的总数，包括其 quantity。eBay 已付款订单适配器的 meta.ebayPurchase.quantity 会保留。

salesSettings.auctionSource 启用 Whatnot 或 eBay Live 商品助手。控制响应中的 commerce.auction 仅包含最近捕获内容中的 source、title、priceText、status 和 at： auction_update，或 null。五分钟后过期，并在来源更改、空闲快照或重启时清除。该辅助工具仅供操作员使用：既不持久保存，也不纳入面向观众的广播；出价者/获胜者身份会被丢弃。来源脚本和拍卖事件载荷保持不变。复制草稿不会确认付款，也不会创建销售。

事件流音频控件

操作叠加接受 actionType: "play_audio" 带有 audioUrl, volume (0–1)，可选 audioPlayback: "queue" 或 "interrupt"。省略播放选项会保持重叠播放。当地媒体继续使用 sourceType: "local", localAssetId，以及 localAssetName。队列模式可容纳多达 30 个等待剪辑，每个剪辑的时长限制为两分钟；中断模式替换该队列的当前剪辑并清除其等待项目。

actionType: "stop_audio" 停止 Flow Actions 音频剪辑并清除声音队列。这些是覆盖控制消息，而不是源聊天事件或听到 OBS 输出的证据。事件流在发送操作之前将配置的随机声音设置为一个音频 URL。参见事件流设置.