让每一次分享更顺手
排错与反馈
先确认声音在哪里出了问题，再留下能帮助复现的线索。
先做这几个检查
房间听不到音乐，本机却听得到
确认已经进房、在台上、解除房间 Mute，再检查音乐是否正在播放、Stage Broadcast Music Volume 是否过低。本机监听音量不能代表房间发送音量。
房间有声，本机却听不到
检查 Output 是否设为 Off，输出设备是否选对，以及 Music Playback Volume 和 Room Speakers Voice Volume。蓝牙和虚拟声卡也可能改变声音去向。
麦克风没声，音乐却正常
检查 Input 是否为 Off、麦克风音量、系统麦克风权限，以及设备是否被拔掉或占用。Input Off 仍允许音乐和音效广播。
音乐说话时变小，或者歌曲忽大忽小
先检查 Ducking 是否在触发；歌曲间的响度差异与 Limiter 控峰值是两回事。可选响度统一只作用于本地音乐，并会产生解码分析开销。
开启日志，再复现一次
日志默认关闭。没有开启时发生的问题，通常没有对应文件日志可回溯。Mac 的 Help 在屏幕顶部系统菜单栏，不需要开发者工具。
Help → Save Logs to File
勾选保存日志，然后再开始复现问题。
重新操作，记下时间
记录发生的本地时间和时区，以及预期和实际结果。
Help → Open Logs Folder
找到对应的 studio-YYYY-MM-DD.log。
检查后，私下反馈
将相关日志和说明私下发送给 Angel。排查结束可取消 Save Logs to File。
以上为操作流程示意，不是软件截图。Help 菜单勾选与日志文件夹的真实步骤截图待补。
日志在哪里？
优先使用菜单打开。默认位置：
- Windows：
%APPDATA%\Clubhouse Studio\logs - macOS：
~/Library/Application Support/Clubhouse Studio/logs - Linux：通常为
~/.config/Clubhouse Studio/logs，可能受 XDG 配置影响。
文件名和日志时间戳使用 UTC，可能与记录的本地日期不同。每天约 5 MiB 上限；启动以及打开或轮换日志文件时，会清理修改时间超过 7 天的本应用日志。退出后没有后台定时清理服务。
分享前，检查一下
日志有敏感字段过滤，但不能保证完全不含个人信息。先检查路径、设备名等，只私下发送相关文件。不要发送 profile.json、验证码、手机号、token、Cookie、遥控配对密钥或整个应用数据目录。本站没有公开日志上传入口。
日志中出现 SDP / STUN 不自动代表故障，请一并说明听到的现象和发生时间。
复制这份反馈模板
软件版本、系统版本、CPU 架构： 发生时间（含时区）： 操作步骤： 预期结果 / 实际结果： 输入 / 输出设备；蓝牙或虚拟声卡： 是否双 Off、是否在台上、是否房间静音： 本地音乐 / YouTube；开启的 add-ons： 本机听到的问题 / 另一台设备作为听众听到的问题： 复现频率： 相关日志和必要截图（分享前检查隐私）：
通过 Telegram 反馈机器人 ↗ 提交问题。请勿在公共群里暴露登录信息。