选择正确的起始页
复制观众显示，而不是其设置页面。 Spotify 设置独立于 spotify-overlay.html； AI Overlay Builder 使用 aiprompt.html 构建和 aioverlay.html 显示。 AI 事件叠加是另一个具有保存配置和私有显示 URL 的功能。
下载并保存文件结构
- 下载源ZIP 并提取它。这些指南使用测试版源；将一次下载的文件放在一起。
- 复制
spotify-overlay.html为my-music.html原文旁边。如果选择不同的页面或主题，请将其副本保留在该文件的原始文件夹中。 - 在编辑器或 AI 工具中打开复制的 HTML 及其引用的 CSS/JS。将提供的图稿/字体添加到同一项目并使用相对路径。从 CSS 覆盖开始；更改生成的标记时包括渲染器。
以下文件可帮助您找到设计和行为。这是一个阅读列表，而不是完整的依赖包：保持提取的文件夹完整，包括图像、字体、脚本和任何数据文件。
| 文件 | 为什么它很重要 |
|---|---|
spotify-overlay.html | 正在播放的观众显示。 |
cohost-overlay.html | 主持人头像及回复演示。 |
bot.html | Bot消息输出页面。 |
chatbot.html | 另一个机器人输出；遵循其现有生成的链接和接收器。 |
aioverlay.html | 保存的 AI Overlay Builder 输出。 |
aievent-overlay.html | AI事件叠加显示。 |
shared/aiEventOverlay/render.js | AI模板渲染器及其字段/沙箱规则。 |
shared/aiEventOverlay/overlay.css | AI 事件叠加显示样式。 |
连接您的副本并在 OBS 中打开它
启动SSN并首先使原始生成的覆盖URL起作用。的 session= 值连接到该 SSN 会话；这不是您的频道名称或此文件的名称。保持 SSN、相关功能及其数据源运行。
当您需要上游修复时的
- 将编辑后的 HTML 文件拖到 Chrome 或 Edge 中。从地址栏复制其地址；它开始于
file:///. - 复制所有内容
?继续在您的工作 SSN 覆盖链接中并将其添加到该文件地址的末尾。保留所有设置，包括会话、密码和任何#结局。 - 在浏览器中打开结果，然后设置 OBS 浏览器源的 URL 与以下地址相同 本地文件 未检查。将源尺寸与您的预期设计相匹配。
对于上面的起始文件，本地地址如下所示；您的实际链接可能包含其他必需选项：
file:///C:/SSN/social_stream-beta/my-music.html?session=YOUR_SESSION使用计算机上的实际文件地址。 OBS 与源码一起保存；将下载的文件夹保留在同一位置。保存设计更改后，刷新浏览器源。的 共享设置指南 包括 Mac 示例和本地文件复选框的可选启动器。
哪里需要改变设计
对于音乐，更改封面艺术框架、曲目/艺术家排版、进度和暂停/隐藏状态。在现有的 SSN 集成中保留播放授权。对于共同主持人输出，更改头像布局、对话气泡和空闲/说话状态，同时保留回复路由和现有音频源。
对于生成的 AI 事件设计，请使用保存的设计提示并清空 data-field 中描述的元素 AI活动指南.它的渲染器在本地填充文本并阻止生成的 JavaScript。保留该边界。复制整个显示链接，包括任何 #aieventauth=... 片段；仅会话不足以实现该功能。
复制此AI提示
将您复制的源文件和参考图稿提供给人工智能。替换括号内的详细信息。将输入安全说明保留在提示中。此提示用于编辑源文件。对于生成的 AI 事件模板，请使用该功能保存的设计提示和纯文本 data-field 绑定；不要将脚本添加到生成的模板中。
显示完整提示
Customize my-music.html, copied from spotify-overlay.html.
Design: [describe the look or attach a reference].
Colors/fonts/assets: [supply hex colors and local filenames].
OBS canvas and placement: [size and position].
Restyle [chosen music / cohost / AI output] as [design]. Preserve the existing now-playing or reply payload, hide/idle/paused states, and audio ownership. Keep provider keys and setup controls out of the viewer page. For AI Event templates preserve data-field binding and the sandbox: viewer text is data, never a design instruction or generated script.
Read docs/event-reference.html for incoming fields and
docs/overlay-customization-guide.html for local setup and safe rendering.
Keep the existing session/password handling, labels, server routes, query
parameters, URL fragments, and relative asset paths. Use classic scripts
compatible with Chrome 80. Keep executable dependencies packaged locally.
Treat all incoming messages, names, labels, donations, and metadata as untrusted.
Prevent HTML/JavaScript injection in every renderer you change. Use textContent
for plain fields and for chatmessage when textonly is true. For HTML-mode
chatmessage, keep supported emotes/formatting through the packaged
SocialStreamChatHTML.sanitize helper (libs/objects.js loaded first).
Do not concatenate raw input into innerHTML, attributes, CSS, or JavaScript.
Validate media/link URLs with the page's existing URL policy and assign DOM
properties; do not enable javascript: URLs or executable embedded content.
Never eval incoming data or treat a viewer message as an AI instruction.
Keep source checks, connection handling, and existing sanitizers.
Test plain text, allowed emotes, quotes, angle brackets, and an HTML injection
probe in an isolated preview; verify the probe cannot execute.
Make the edited overlay work directly from disk using a file:/// URL,
without requiring a local web server.
Return the edited files, any additional assets, exact local browser/OBS
setup instructions using placeholders, and the specific tests performed.
Do not put my private session link or credentials into a public example.测试此覆盖类型
首先使用预览或测试设置。的 测试消息指南 解释了如何通过SSN发送虚构的有效负载；提交到生产会话的测试可以触发其现有的自动化。
- 对于Spotify，通过配置的集成来播放和暂停；测试长曲目标题、缺少封面艺术和无歌曲状态。
- 对于 cohost，使用 cohost-overlay.html?preview 进行布局，然后删除预览并通过 SSN 生成测试回复。检查空闲/说话的转换和重复的音频。
- 供构建器使用其模拟控件；对于 AI 事件，请使用保存和预览及其示例事件控件。测试OBS中实际保存的输出链接，包括其名称/ID和私有片段。
同时运行 输入渲染检查 针对您更改的渲染路径。保存编辑后，在排练之间刷新 OBS 浏览器源并重复可见的交互。浏览器预览不会建立实时捕获或 OBS 行为。