OBS 开播监听助手 v1.0.1

Delta Harmonica OBS 开播监听助手（Windows）

一、运行条件

• Windows 10 或更高版本，内置 Windows PowerShell 5.1。
• OBS Studio 28 或更高版本，并启用 OBS WebSocket 服务。
• 电脑登录主播使用的 Windows 账户；开机自启只对当前账户生效。

二、首次安装与连接

1. 将下载的 ZIP 解压到一个固定文件夹。启用开机自启后不要移动或删除此文件夹。
2. 双击 Start.cmd 打开监听助手。
3. 登录网站，进入「合作 → 主播控制台」，点击「生成设备令牌」。令牌只显示一次，请立即复制到助手的「主播设备令牌」栏。
4. 在 OBS 打开「工具 → WebSocket 服务器设置」，启用 WebSocket 服务器。默认地址为 ws://127.0.0.1:4455；把 OBS 显示的服务器密码填入助手。
5. 检查本站地址与 OBS WebSocket 地址，然后点击「连接并开始监听」。看到已连接状态即完成。

三、启用开机自启

1. 完成上面的首次填写后，勾选窗口底部「登录 Windows 后自动启动并连接监听」。
2. 助手会把启动快捷方式放入当前 Windows 账户的启动文件夹。之后登录 Windows 时，助手会自动打开并尝试连接 OBS、开始监听，无需再手动点击连接。
3. OBS 必须启动且 WebSocket 服务可用。建议在 OBS 的常规设置中同时启用「启动时自动运行 OBS」。如果助手先于 OBS 启动，它会每 10 秒自动重试连接。
4. 取消勾选即可关闭开机自启，并删除本机保存的设备令牌和 OBS 密码。也可以在 Windows「任务管理器 → 启动应用」中禁用该助手。

隐私与安全

• 为支持自动连接，启用开机自启后，助手会在本机保存本站地址、OBS 地址、设备令牌和 OBS 密码。令牌和密码使用 Windows 当前用户的 DPAPI 加密；其他 Windows 账户或电脑不能直接解密。不要把配置文件或设备令牌分享给他人。
• 本地配置位于 %LOCALAPPDATA%\DeltaHarmonica\ObsStreamMonitor。取消勾选自启会删除配置文件。
• 设备令牌仅发送到本站 HTTPS 状态接口。助手不会录制或传输直播画面、声音。

监听效果

• 开播后，助手每 25 秒查询当前周期兑换码，并在 OBS 当前场景创建或更新名为 DeltaHarmonicaDailyCode 的白色文字源。
• 停播时会隐藏文字源。你可以像调整其他 OBS 文字源一样移动或缩放它。
• 兑换码按北京时间每日 05:00 更新；监听在线状态也每 25 秒同步到合作主播页面。
• 关闭助手时会尝试报告离线并隐藏文字源。主播控制台可以撤销设备令牌，阻止该安装继续上报。

常见问题

• 无法连接 OBS：确认 OBS 已启动、WebSocket 服务已启用，地址和端口正确，密码无误。
• 自动启动后连接失败：确认 OBS 已启动并启用 WebSocket；助手会每 10 秒自动重试，也可手动点击连接。
• 令牌无效：在主播控制台生成新设备令牌，并在助手中替换。
• 无法连接网站：确认本站地址使用 HTTPS，并允许电脑访问本站及本机 OBS WebSocket。

OBS 开播监听助手 v1.0.0

Delta Harmonica OBS 开播监听助手（Windows）

一、运行条件

• Windows 10 或更高版本，内置 Windows PowerShell 5.1。
• OBS Studio 28 或更高版本，并启用 OBS WebSocket 服务。
• 电脑登录主播使用的 Windows 账户；开机自启只对当前账户生效。

二、首次安装与连接

1. 将下载的 ZIP 解压到一个固定文件夹。启用开机自启后不要移动或删除此文件夹。
2. 双击 Start.cmd 打开监听助手。
3. 登录网站，进入「合作 → 主播控制台」，点击「生成设备令牌」。令牌只显示一次，请立即复制到助手的「主播设备令牌」栏。
4. 在 OBS 打开「工具 → WebSocket 服务器设置」，启用 WebSocket 服务器。默认地址为 ws://127.0.0.1:4455；把 OBS 显示的服务器密码填入助手。
5. 检查本站地址与 OBS WebSocket 地址，然后点击「连接并开始监听」。看到已连接状态即完成。

三、启用开机自启

1. 完成上面的首次填写后，勾选窗口底部「登录 Windows 后自动启动并连接监听」。
2. 助手会把启动快捷方式放入当前 Windows 账户的启动文件夹。之后登录 Windows 时，助手会自动打开并尝试连接 OBS、开始监听，无需再手动点击连接。
3. OBS 必须启动且 WebSocket 服务可用。建议在 OBS 的常规设置中同时启用「启动时自动运行 OBS」。如果助手先于 OBS 启动，它会每 10 秒自动重试连接。
4. 取消勾选即可关闭开机自启，并删除本机保存的设备令牌和 OBS 密码。也可以在 Windows「任务管理器 → 启动应用」中禁用该助手。

隐私与安全

• 为支持自动连接，启用开机自启后，助手会在本机保存本站地址、OBS 地址、设备令牌和 OBS 密码。令牌和密码使用 Windows 当前用户的 DPAPI 加密；其他 Windows 账户或电脑不能直接解密。不要把配置文件或设备令牌分享给他人。
• 本地配置位于 %LOCALAPPDATA%\DeltaHarmonica\ObsStreamMonitor。取消勾选自启会删除配置文件。
• 设备令牌仅发送到本站 HTTPS 状态接口。助手不会录制或传输直播画面、声音。

监听效果

• 开播后，助手每 25 秒查询当前周期兑换码，并在 OBS 当前场景创建或更新名为 DeltaHarmonicaDailyCode 的白色文字源。
• 停播时会隐藏文字源。你可以像调整其他 OBS 文字源一样移动或缩放它。
• 兑换码按北京时间每日 05:00 更新；监听在线状态也每 25 秒同步到合作主播页面。
• 关闭助手时会尝试报告离线并隐藏文字源。主播控制台可以撤销设备令牌，阻止该安装继续上报。

常见问题

• 无法连接 OBS：确认 OBS 已启动、WebSocket 服务已启用，地址和端口正确，密码无误。
• 自动启动后连接失败：确认 OBS 已启动并启用 WebSocket；助手会每 10 秒自动重试，也可手动点击连接。
• 令牌无效：在主播控制台生成新设备令牌，并在助手中替换。
• 无法连接网站：确认本站地址使用 HTTPS，并允许电脑访问本站及本机 OBS WebSocket。

Harmonica Recorder v2.3.1

修复重复从网页唤起录制助手时，已有助手窗口无法接收曲谱且新进程静默退出的问题。现在转交失败时会打开独立窗口，并提示关闭旧窗口；同时调整了窗口就绪时机和当前用户的管道权限。

下载 ZIP 后解压到固定目录，运行 Install.cmd 注册协议。如果移动了目录，请重新运行 Install.cmd。

Harmonica Recorder v2.3.0

Full Changelog: helper-v2.1.0...helper-v2.3.0

Harmonica Recorder v2.1.0

Full Changelog: helper-v2.0.0...helper-v2.1.0

Harmonica Recorder v2.0.0

Full Changelog: https://github.com/JikoSchnee/delta-harmonica-macro/commits/helper-v2.0.0