清晰展示评论
将普通评论、初次来的观众、会员和醒目留言显示到 OBS 浏览器源。
- 普通聊天显示
- 聊天置顶
- 醒目留言高亮
- 放置到直播画面布局
Help
Castdeck ヘルプ
アプリ内ヘルプと同じ内容を、公式サイトでも確認できます。配信前の設定確認や、別端末での手順確認に使ってください。
功能一览
Castdeck 是一款直播辅助应用，可统一管理 YouTube Live 的评论、特效、语音朗读、游戏、通知和 OBS 显示。
播放特效
可根据评论、醒目留言等条件，播放图片、视频、音频和画面效果。
- 素材管理
- 触发条件
- 测试播放
- 切换特效组合
让直播变成游戏
将老虎机、转盘、投票、弹珠竞速等观众参与型组件显示到 OBS。
- 老虎机
- 转盘
- 投票
- 观众参与型游戏
助力直播后的改进
整理 AI 顾问、统计、咨询，以及未来可用于营销分析的信息。
- AI 建议
- 统计栏
- 联系支持
- 活用直播数据
各界面的使用方法
这里介绍常用界面及其作用。开播前请重点检查仪表盘、画面特效、直播画面布局和设置。
仪表盘
连接 YouTube Live，查看评论、醒目留言、置顶和语音朗读的状态。
- 通过直播 URL 或直播 ID 连接
- 查看评论和醒目留言
- 进行置顶和标记已处理等操作
画面特效
调整主题、特效、聊天框、置顶、统计、目标和素材管理。
- 特效规则
- 素材管理
- 语音朗读
- 各 OBS 组件的外观
直播画面布局
将聊天、置顶、统计、目标、特效、游戏、BGM、音效等放置到一个 OBS 用画面中。
- 添加组件
- 调整位置和大小
- 保存布局
- 查看 OBS 用 URL
设置
管理 Google、AI、表情符号、OBS、BASE、Amazon、更新等外部联动。
- Google 认证
- AI API 设置
- OBS WebSocket 联动
- 购买与礼物通知
AI API 设置
使用 AI 顾问时，需要设置所用 AI 服务的 API 密钥或本地 LLM 的连接地址。
Claude / OpenAI / Gemini
在各服务的官方控制台创建 API 密钥，并保存到 Castdeck 的偏好设置中。
- 创建 Castdeck 专用密钥
- 确认用量上限和账单状态
- 不要在公开网站或 OBS 中显示密钥
Local LLM
使用 Ollama 等 OpenAI 兼容服务器，可以在不产生 API 费用的情况下进行测试。
- 设置本地 LLM 的 URL
- 选择模型
- 在正式直播前确认响应速度和质量
费用与安全
AI API 可能按用量计费。请在直播前设置费用上限和提醒。
- 每月费用上限
- 预算提醒
- 停用不使用的密钥
- 检查直播中是否有过多调用
购买与礼物通知指南
本页介绍将 BASE 订单和 Amazon 心愿单同步显示到直播画面通知组件的设置步骤。
BASE 联动可以做什么
检测 BASE 商店的新订单，并作为购买/礼物通知显示到 OBS 直播画面。
- 定期获取订单列表
- 只通知新订单
- 将商品名、购买者姓名和金额反映到通知中
- 购买者姓名以首字母显示
在 BASE Developers 端的准备工作
在测试版中，需要主播自行创建 BASE 应用，并将发放的 Client ID 和 Client Secret 输入到 Castdeck。
- 在 BASE Developers 创建应用
- 启用“查看商店信息”和“查看订单信息”权限
- 在 callback 中登记 http://127.0.0.1:3039/callback
Castdeck 端的设置步骤
在偏好设置的外部服务联动中，按保存、认证、连接测试、通知测试的顺序确认。
- 保存 Client ID 和 Client Secret
- 在 BASE 上进行认证
- 进行连接测试
- 放置购买/礼物通知组件
- 发送测试通知
Amazon 心愿单通知
同步已购买列表，将比上次新增的商品显示为购买/礼物通知。
- 打开已购买筛选
- 通过小书签（bookmarklet）同步
- 首次同步时记录基准
- 第二次起只通知新增部分
OBS WebSocket 联动指南
这是一项可选设置，可随 OBS 场景切换自动控制 Castdeck 布局的 BGM、音效和视频声音。
OBS 联动可以做什么
自动停止未在显示中的 Castdeck 布局的 BGM、音效和视频声音。
- 即使不启用此联动，普通的 OBS 显示也可正常使用
- 防止多个场景的声音残留
- 获取当前场景名称
- 对 Castdeck 浏览器源进行静音控制
OBS 端的设置步骤
OBS 28 及以后版本已内置 WebSocket 功能。
- 打开 OBS
- 从“工具”菜单打开 WebSocket 服务器设置
- 启用 WebSocket 服务器
- 确认端口为 4455
- 如启用了身份验证，请确认密码
Castdeck 端的设置步骤
在偏好设置的外部联动中，填写 OBS 的主机、端口和密码。
- 启用 OBS 联动
- 同一台电脑时主机填 127.0.0.1
- 端口为 4455
- 输入密码
- 开启声音控制
- 进行连接测试
无法连接时
出现 ECONNREFUSED 或未连接提示时，可能是 OBS 端的 WebSocket 服务器未在监听。
- 确认 OBS 是否已启动
- 确认 WebSocket 服务器设置是否已开启
- 确认端口号
- 确认密码
- 如果在另一台电脑上，请确认 IP 地址和防火墙
没有声音时
除 WebSocket 联动外，也请检查 OBS 浏览器源自身的音频控制设置。
- 在 OBS 浏览器源的属性中开启“通过 OBS 控制音频”
- 检查 OBS 混音器
- 确认 Castdeck 的连接测试
- 确认当前显示的场景中是否有 /layout 浏览器源
- 暂时关闭 OBS 联动进行确认
连接其他平台
也可以把 YouTube 以外直播平台的评论统一导入 Castdeck。
连接方法
支持 Twitch、TwitCasting、Kick、Niconico 直播和 Whowatch。
- 在偏好设置的“直播账号关联”中，通过想要连接的平台卡片进行关联
- Twitch 和 TwitCasting 通过账号关联连接，Kick 通过指定频道名连接
- 连接后，各平台的评论会汇总显示在仪表盘中
实验性支持的注意事项
部分平台为实验性支持，容易受平台规格变更的影响。
- Niconico 直播、Whowatch 和 Kick 为实验性支持，可能因对方平台的规格变更而失效
- 无法获取评论时，请先断开连接再尝试重新连接
- 语音朗读、置顶和特效规则对任何平台的评论都同样适用
画面特效中的各项功能
介绍主题、特效、聊天框、置顶、统计、目标、语音朗读和素材管理各自的用途。
主题与预设
统一聊天框、置顶、统计栏、目标等的配色和外观。
- 选择主题
- 同步开/关
- 单独自定义
特效
以评论、醒目留言（Super Chat）、订阅、点赞等为条件，播放音频、图片、视频和特效。
- 触发条件
- 选择素材
- 出现位置
- 测试播放
素材管理
将图片、音频和视频添加到应用内的文件管理器，并在各设置界面中引用。
- 上传到素材保存位置
- 确认名称和类型
- 在特效或布局中选用
特效的使用方法
这是在直播中播放音频、图片、视频和画面效果的基本步骤。
1
在画面特效中打开素材管理，添加想使用的音频、图片和视频。
2
在特效标签页创建触发规则，设置评论、醒目留言金额、订阅、点赞等条件。
3
为规则指定显示素材、音效、文字和显示时长。
4
在直播画面布局中放置特效组件，OBS 中只需粘贴一个直播画面布局 URL。
5
通过测试播放确认特效能在 OBS 中显示、声音能正常播放。
6
直播中出现符合条件的事件时，特效会自动触发。
v0.5 新功能
介绍近期更新中新增功能的使用方法。
按画面区分的特效规则
特效规则可按“全画面通用”和“仅此画面”分开使用。
- 在布局编辑器的特效规则中，可为每条规则切换适用范围
- “仅此画面”只有在该布局正于 OBS 中直播显示时才会触发
- 同时显示多个不同布局时无法确定当前画面，此时只有全画面通用规则会触发
媒体的常驻显示与临时播放
添加图片或视频组件时，可以选择显示方式。
- “常驻显示”会一直显示在放置的位置（适合 Logo、边框等）
- “临时播放”会作为特效规则添加，可通过手动按钮或评论条件播放
- 临时播放的触发条件可随时在特效规则的检查器中修改
组件添加浏览器
组件和特效的添加已统一到“添加组件”浏览器中。
- 单个特效可从“反应”类别中选择，当场设置触发条件和内容后添加
- 老虎机、投票、BGM 等每个布局最多只能放一个（若已放置，会引导你编辑现有组件）
- 老虎机可通过检查器中的“测试旋转”，在不满足参与条件的情况下确认运行效果
评论翻译（Pro，即将推出）
自动翻译并显示来自海外的评论。正式版即将上线。
- 通过仪表盘的翻译开关切换开/关
- 包含日语假名的评论会跳过翻译，快速显示
- 计划作为 Castdeck Pro 的功能提供
语音建议
将主播的声音转成文字，作为 AI 顾问的参考素材。
- 在 AI 顾问界面启用语音建议
- 语音转文字在本机（本地 Whisper）完成，声音不会被发送到外部
- 首次使用时下载模型可能需要几十秒
使用 VOICEVOX 或 COEIROINK 朗读
可以为朗读引擎使用角色语音。
- 先在电脑上启动 VOICEVOX 或 COEIROINK
- 在语音朗读设置中选择引擎和说话人，并通过测试播放确认
- 朗读没有声音时，请确认引擎是否已启动
故障排查
可按原因逐一排查常见的问题。
无法连接 YouTube
可能在直播 URL、认证或 API 权限的某个环节出现了问题。
- 检查 Google 登录状态
- 确认是否为当前的直播场次
- 确认直播聊天是否已启用
- 断开后重新连接
OBS 中什么都不显示
检查 URL、源尺寸和叠加层服务器的状态。
- 确认布局 URL
- 将 OBS 浏览器源的宽/高设为直播分辨率
- 保持应用运行的同时刷新 OBS
- 刷新浏览器源的缓存
音频或视频不播放
检查素材添加、OBS 音频设置和文件格式。
- 确认素材已添加到素材管理
- 在 OBS 浏览器源的属性中开启“通过 OBS 控制音频”
- 检查 OBS 浏览器源是否被静音
- 如已开启 OBS 联动，请确认连接测试和当前场景
- 检查音量设置和电脑的音频输出设备
设计未生效
检查同步设置，并在 OBS 端重新加载。
- 检查主题同步
- 检查自定义模板
- 刷新 OBS 浏览器源
- 重新应用主题预设
遇到问题时
不必慌张，按对直播影响从小到大的顺序逐项检查。
首先要检查的事项
直播中显示或声音中断时，先从基本状态开始检查。
- 应用、OBS 和 YouTube Studio 是否正在运行
- 仪表盘是否已连接到直播
- OBS 中是否已设置布局 URL
- 素材管理中是否有所需素材
恢复的基本步骤
按顺序刷新 OBS 与 Castdeck 的连接。
- 刷新 OBS 浏览器源
- 在 Castdeck 中断开直播连接后重新连接
- 重新保存 Google 登录或 API 密钥
- 重启应用并确认 URL
Pro 版（订阅）的取消与付款
取消订阅无需联系支持，随时可通过 Paddle 的邮件自行完成。
Pro 版的购买与生效
购买通过浏览器付款（Paddle）完成，权益会与 Google 账号联动自动生效。
- 点击升级界面的“升级到 Pro 版”后，浏览器会打开付款页面
- 购买后回到应用，点击“购买完成后同步”（需使用与购买时相同的 Google 账号登录）
- 如果提示“未找到购买记录”，请等待几十秒后重试
取消订阅的步骤
Castdeck Pro 的付款由登记商户（Merchant of Record）Paddle 处理。
- 打开购买时的确认邮件，或每月的收据邮件（发件人：Paddle）
- 打开邮件中的 “Manage subscription”（管理订阅）链接
- 选择 “Cancel subscription”（取消订阅）
取消订阅的注意事项
取消时间与退款的处理如下。
- 取消后，在当前计费周期结束前仍可使用 Pro 功能
- 不提供按天折算的退款（重复扣款或误扣款请通过本页的联系方式咨询）
- 找不到邮件时，请在垃圾邮件文件夹中搜索 “paddle”
- Free 方案下直播画面会显示 Castdeck 标识（水印），Pro 版可将其隐藏（正式上线后）