指南

1. 安装

使用Social Stream Ninja前需要先安装。浏览器扩展有多种安装方式：

• 手动安装（推荐）： 要使用最新版本，请在开发者模式中手动安装。
• Chrome网上应用店： 通过Chrome网上应用店安装，设置最为简单。

详细安装说明请访问 下载页面.

2. 基本设置

安装后，请按以下步骤开始使用Social Stream Ninja：

1. 在浏览器中打开直播平台的聊天（如果支持，也可使用弹出聊天功能）
2. 点击浏览器工具栏中的Social Stream Ninja扩展图标
3. 点击“Enable Extension”启用扩展（图标应变为绿色）
4. 打开扩展弹出菜单提供的“Dashboard Link”
5. 在OBS中将“Overlay Link”作为浏览器源打开

3. 连接不同平台

Social Stream Ninja支持100多个平台。以下是连接常用平台的方法：

文字转语音

Social Stream Ninja可以使用文字转语音技术朗读聊天消息：

设置文字转语音：

1. 添加 &speech=en-US 到featured.html或dock.html的URL
2. 对于其他语言，请选择支持该语言的提供商和音色。例如，葡萄牙语可使用Piper &pipervoice=pt_BR-faber-medium 或eSpeak &espeakvoice=pt-br，而西班牙语可以使用Piper &pipervoice=es_ES-davefx-medium 或eSpeak &espeakvoice=es.
3. 使用以下参数自定义语音设置： &pitch=1&volume=1&rate=1

免费的本地文字转语音选项（无需API密钥）：

• Kokoro TTS： 浏览器内置AI，效果出色 — &ttsprovider=kokoro
• Piper TTS： 快速、轻量的神经网络文字转语音 — &ttsprovider=piper
• eSpeak-NG： 轻量级的语言备用方案，包括葡萄牙语 &espeakvoice=pt-br 以及西班牙语 &espeakvoice=es
• Kitten TTS： 占用最小，仅需CPU — &ttsprovider=kitten
• 自托管服务器： 通过Docker在本地运行Kokoro-FastAPI或openedai-speech — &ttsprovider=openai&openaiendpoint=http://localhost:8880/v1/audio/speech

优质云端文字转语音选项：

• Google Cloud TTS： 专业级音色（需要Google API密钥）
• ElevenLabs： 超逼真音色，支持自定义声音训练
• Speechify： 自然的优质音色

AI搭档、聊天机器人和浏览器助手

Social Stream Ninja可以用多种方式使用AI。请先选择工作流程，再选择提供商。

• 语音搭档： 通过麦克风交谈，同时让实时聊天提问进入同一个搭档会话。
• ChatGPT浏览器助手： 捕获聊天，或通过实验性功能将聊天转发到已打开的 chatgpt.com 标签页，无需API密钥。
• 主聊天机器人： 在叠加层中、通过文字转语音或在支持的聊天中回复选中的观众。
• 处理工具： 内容审核、翻译、摘要、RAG知识搜索和AI构建的叠加层。

选择AI设置

消息排队与置顶

安排消息在叠加层中的显示方式：

消息排队：

1. 按住CTRL（Mac上为Cmd）并点击仪表板中的消息
2. 点击“Next in Queue”按钮，逐条显示消息
3. 消息将按入队顺序出现在叠加层中

置顶消息：

1. 按住ALT并点击仪表板中的消息
2. 消息将保持置顶在仪表板顶部
3. 要取消置顶，请按住ALT并再次点击已置顶消息

直播事件捕获

从直播平台捕获新关注、订阅、突袭和打赏等非聊天事件。

启用方法：

1. 点击Social Stream Ninja扩展图标
2. 找到 “捕获直播事件”（Capture Stream Events） 设置中的开关
3. 启用后即可开始接收提醒

各平台可捕获的事件：

有关完整的事件负载和数据字段列表，请参阅 事件参考 文档。

Hype Train顶部栏

在OBS中以Twitch风格的顶部栏显示Hype Train和Treasure Train的进度。

• 从弹出菜单复制专用的Hype Train Top Bar链接。
• 正式直播前，使用Fake Hype Train按钮进行测试。
• 请参阅指南中的设置步骤、截图和故障排除。

打开Hype Train顶部栏指南

首次发言者

突出显示首次发言者，添加可选的叶子徽章，或只在首次发言时播放停靠面板提示音。

• 保持本地消息数据库启用。
• 开启首次发言者检测。
• 选择适合叠加层的高亮、徽章和提示音选项。

打开首次发言者指南

Event Flow 编辑器

Event Flow编辑器是强大的节点式自动化系统，可用于创建自定义工作流程。它提供高级自动化功能，让您编写自己的路由逻辑。

可以做什么：

• 在平台之间转发聊天 通过智能筛选（例如将Twitch转发到Discord，但屏蔽命令）
• 创建自定义命令 通过AND／OR／NOT逻辑门
• 触发叠加层和音频 根据指定事件或关键词
• 控制OBS 自动控制场景和来源
• 创建抽奖和赠奖活动 并管理队列

入门：

1. 从主仪表板菜单打开Event Flow编辑器
2. 创建新流程并添加来源节点（如“Twitch Message”）
3. 连接逻辑节点以筛选消息（Contains Keyword、User Role等）
4. 添加响应的动作节点（Send Chat、Play Audio、Display Overlay）
5. 正式直播前，使用内置模拟器进行测试

Flow Actions叠加层：

要让音频、媒体叠加层和OBS动作生效，需要将Flow Actions页面作为浏览器源添加到OBS：

1. 在弹出菜单中找到“Flow Actions”部分并复制URL
2. 在OBS中将其添加为浏览器源（建议1920×1080）
3. 保持叠加层打开（可以隐藏，但不要关闭）

MIDI 与快捷键控制

通过Stream Deck、MIDI控制器或键盘快捷键直接控制Social Stream Ninja。

设置MIDI：

1. 连接MIDI设备（Stream Deck、MIDI控制器等）
2. 打开Social Stream Ninja弹出菜单
3. 找到MIDI设置部分
4. 从下拉菜单中选择MIDI设备
5. 将MIDI音符映射到指定动作

可用动作：

• 触发自定义叠加层和媒体
• 发送预设聊天消息
• 切换OBS场景
• 播放音频片段或文字转语音
• 执行Event Flow触发器

机器人命令与自动回复

为聊天创建交互式机器人命令和自动回复。

内置命令：

• !joke - 发送一条随机的极客冷笑话
• !hi - 自动问候观众
• !cycle - 允许观众切换OBS场景（需要权限）

设置自动回复：

1. 打开扩展弹出菜单并找到Bot／Auto-Response部分
2. 启用需要的命令
3. 保持聊天窗口可见，不要最小化，才能让回复生效
4. 确保已登录平台并具有发言权限

创建自定义命令：

对于更复杂的命令，请使用Event Flow编辑器：

1. 创建一个使用Message来源的新流程
2. 添加“Contains Keyword”节点来检测命令（如“!social”）
3. 连接一个“Send Chat”动作并填写回复
4. 可添加User Role筛选器，将命令限制为仅版主可用

Webhook与集成

连接外部打赏平台，在直播叠加层中显示打赏和购买。

前提条件：

1. 记下扩展弹出菜单中的会话ID
2. 保持Social Stream Ninja启用
3. 位于 Global settings and tools → Mechanics，启用 扩展的远程 API 控制
4. 使用正常生成的停靠面板和叠加层链接；不要添加 &server, &server2，或 &server3 用于打赏Webhook
5. 如果停靠面板已经打开，请重新加载一次

只需启用一个API开关： 远程API控制允许后台脚本标准化打赏Webhook，并像普通消息一样传递。其他API传输开关可以保持关闭。

标准化后的打赏会共享给聊天、提醒、Event Flow，以及打赏罐／目标进度条。

支持的平台：

Stripe设置：

1. 创建一个 Stripe付款链接
2. 重要： 为付款链接添加自定义字段：
   • 显示名称 或 用户名 （必填）- 缺少此字段会拒绝打赏
   • 消息 （可选）- 允许打赏者留言
3. 前往 Stripe Webhooks 并创建新的端点
4. 将URL设置为： https://io.socialstream.ninja/YOUR_SESSION_ID/stripe
5. 选择事件： checkout.session.completed
6. 无需签名验证（请改为保密会话ID）

测试： 使用Stripe测试模式，卡号为 4242 4242 4242 4242、任意未来到期日期和任意CVC。

创作者商店设置

使用 图文设置指南 适用于Fourthwall、Ko-fi和Buy Me a Coffee，包括接收状态、独立预览和商品导入。

通过Webhook导出聊天：

您也可以将聊天数据导出到外部服务：

• 在设置中配置出站Webhook URL
• 聊天消息以包含JSON负载的POST请求发送
• 使用此功能记录聊天、触发外部自动化或与其他工具同步

1. 安装

与浏览器扩展相比，独立应用的安装过程更简单：

• Windows： 下载并运行Windows 10／11（x64）安装程序
• macOS： 下载并运行macOS应用
• Linux： 大多数Linux发行版可使用AppImage文件

详细安装说明请访问 下载页面.

2. 基本设置

安装后，请按以下步骤开始使用Social Stream Ninja独立应用：

1. 启动Social Stream Ninja应用
2. 点击左侧栏中要添加的平台对应的按钮
3. 按照提示输入用户名、Video ID或URL
4. 点击“Activate source”或“Select Live Sources”进行连接
5. 复制“Streaming Chat”链接，并在OBS中添加为浏览器源

3. 连接不同平台

独立应用简化了各个平台的连接：

4. 视频教程

观看以下视频，了解独立应用的使用流程：

TikTok 指南

需要TikTok设置、回复、连接模式或TikFinity备用方式的帮助？请使用专门的TikTok指南。

• 应该选择哪种模式：TikTok WS＋Auto、Standard、Local Signer、Polling、Euler Proxy或Euler Signing
• 如何从SSN回复TikTok聊天
• 如何通过Other chat sites使用TikFinity OBS Dock作为备用方式
• TikTok显示您离线、漏收消息、聊天重复或关闭验证窗口时，可尝试的方法

打开TikTok指南

双向聊天

独立应用在支持的平台上提供双向聊天消息功能：

• 直接从仪表板发送消息
• 消息会同时出现在所有已连接的平台
• 使用机器人命令和自动回复

YouTube自定义项目设置

如果希望桌面应用使用您自己的YouTube API配额，请参阅专门的设置指南。其中介绍Google Cloud设置、准确的重定向URL、API密钥限制和基本安全建议。

打开YouTube项目设置指南

Hype Train顶部栏

使用专用的Hype Train Top Bar链接，在OBS中显示Twitch Hype Train和Treasure Train的进度。

• 从弹出菜单复制Hype Train Top Bar URL。
• 自定义对齐、缩放、不透明度和背景设置。
• 使用Fake Hype Train按钮进行测试。

打开Hype Train顶部栏指南

首次发言者

使用首次发言者检测来突出显示新观众、显示叶子徽章，或仅在首次发言时触发提示音。

• 保持本地消息数据库启用。
• 开启首次发言者检测。
• 请参阅指南中的设置步骤、截图和故障排除。

打开首次发言者指南

LLM集成

桌面应用支持相同的AI提供商工具，包括：

• 语音搭档： 结合麦克风对话、实时聊天提问和语音回复。
• 主机器人和私人机器人： 公开聊天回复，或独立的一对一助手。
• AI处理： 内容审核、翻译、摘要和RAG知识搜索。
• 提供商选择： 本地模型、自托管端点或支持的云端API。

打开完整AI指南

直播事件捕获

捕获新关注、订阅、突袭和打赏等非聊天事件。

启用方法：

1. 打开Social Stream Ninja应用
2. 进入设置并找到 “捕获直播事件”（Capture Stream Events）
3. 启用后即可开始接收提醒

可捕获的事件：

• YouTube： 会员、Super Chat、订阅人数
• Twitch： 订阅者、关注者、Bits、突袭、频道积分
• TikTok： 关注者、礼物、观众人数
• Kick： 订阅、打赏和关注提醒

请参阅 事件参考 ，其中包含完整的事件负载文档。

Event Flow 编辑器

使用节点式Event Flow编辑器创建强大的自动化流程。

可以做什么：

• 中继聊天 通过智能筛选在平台之间转发
• 触发叠加层和音频 根据事件或关键词
• 控制OBS 自动控制场景和来源
• 创建自定义命令 通过逻辑门（AND／OR／NOT）
• 创建抽奖和游戏 并管理队列

入门：

1. 从应用菜单打开Event Flow编辑器
2. 创建包含来源节点的流程（Message、Timer、Manual Trigger）
3. 添加逻辑节点进行筛选（Contains Keyword、User Role等）
4. 连接动作节点（Send Chat、Play Audio、Display Overlay）
5. 正式直播前，使用模拟器进行测试

Flow Actions叠加层：

在OBS中将Flow Actions URL添加为浏览器源，以使音频和叠加层动作生效。此URL位于应用的“Flow Actions”部分。

MIDI 与快捷键控制

通过Stream Deck、MIDI控制器或键盘快捷键直接控制应用。

设置方法：

1. 连接MIDI设备
2. 打开设置并找到MIDI部分
3. 从下拉菜单中选择设备
4. 将MIDI音符映射到动作

可用动作：

• 触发叠加层和媒体
• 发送聊天消息
• 切换OBS场景
• 播放音频片段
• 执行Event Flow触发器

Webhook与集成

连接外部打赏平台和服务。

支持的集成：

• Stripe： 付款事件
• Ko-Fi： 打赏提醒
• Buy Me A Coffee： 打赏
• 自定义Webhook： 任何HTTP POST服务

设置：

1. 在应用设置中找到Webhook中继URL
2. 将其添加到打赏平台的Webhook配置中
3. 事件会自动出现在仪表板和流程中