LiveChatter
直播弹幕 分类:Web 描述:接收、显示、过滤、朗读、翻译和发送 B 站直播间弹幕,并可联动触发器与 AI 回复。
需求
- 安全级别:常规模块;远程执行和真实发送弹幕属于高风险能力,默认关闭或受保护。
- 权限需求:接收弹幕通常不需要管理员;发送弹幕、AI 以真实弹幕回复、部分直播间管理能力需要已登录 BiliSettings 账号。
- 驱动依赖:否
- 联网需求:是
- 开发状态:稳定/常规
- 版本属性:普通可用;带 PRO 标记的高级用户筛选能力需要 PRO
介绍
LiveChatter 负责直播弹幕本身:它从 LiveStream 当前房间接收弹幕,按规则筛选后显示在客户端,也可以写入控制台或文件、朗读、翻译、播放提示音、触发命令,并让 AI 生成回复。
发送相关能力会使用 LiveStream 的 Room ID 作为目标房间,包括 /blc、/bili live chatter、剪贴板快速发送、自动发送和 AI 的 Real Chatter 模式。切换到别人直播间观察时,建议保持 Prevent Others Room Chatter Sending 开启,或使用 /bili live switch <roomId> auto,避免误把弹幕发到非自己的直播间。
配置项
- Auto Send Time Mode(自动发送时间模式) 类型:枚举;默认:"Off" 说明:控制是否自动向当前直播间发送弹幕。
Off不自动发送;Periodic按固定间隔发送。自动发送会公开出现在直播间,启用前应确认内容和房间号正确。 可选:Off;Periodic - Auto Send Periodic Interval (ms)(自动发送周期,毫秒) 类型:数值;默认:60000L 说明:
Periodic模式下两次自动发送之间的间隔。间隔过短容易刷屏或触发平台限制,建议按直播节奏设置为几十秒到数分钟。 - Auto Send Content Mode(自动发送内容模式) 类型:枚举;默认:"Fixed" 说明:选择自动发送的内容来源。固定内容适合简单提醒;列表模式适合轮播话术;文件模式适合由外部工具投递待发送文本;预设模式会生成特定类型内容。 可选:Fixed;List Random Element;List Loop;Prefab;File Lines
- Auto Send Prefab Type(自动发送预设类型) 类型:枚举;默认:"Aphorism" 说明:当内容模式为
Prefab时使用的生成类型。Aphorism发送短句;Idiom Solitaire和Ask Solitaire会依赖 AI 生成接龙内容,使用前需确保 AI 配置可用。 可选:Aphorism;Idiom Solitaire;Ask Solitaire - Auto Send Fixed Content(自动发送固定内容) 类型:文本;默认:"给主播点个关注~" 说明:
Fixed模式发送的文本。适合固定欢迎语、关注提醒或直播间口播同步文案。 - Auto Send List Content (Sep With Semicolon)(自动发送列表内容,用分号分隔) 类型:文本;默认:"" 说明:
List Random Element和List Loop的候选文本列表,使用英文分号分隔。内容里如果需要分号,应改用文件模式,避免被拆成多条。 - Auto Send List Current Index(自动发送列表当前索引) 类型:数值;默认:0 说明:
List Loop当前轮播位置。一般不需要手动改;想从列表开头重新发送时可设回 0。 - Auto Send File Source Path(自动发送文件来源路径) 类型:文本;默认:"" 说明:
File Lines模式读取的文本文件路径。模块会读取文件中的每一行并发送,随后清空该文件,适合让脚本或外部程序写入待发送队列。 - Clipboard Quick Send(剪贴板快速发送) 类型:枚举;默认:"Off" 说明:按快捷键后如何取得并发送文本。
Send直接发送当前剪贴板;Copy and Send先复制选中文本;Select All, Copy and Send会先全选再复制。该功能会向当前直播间真实发送弹幕。 可选:Off;Send;Copy and Send;Select All, Copy and Send - Clipboard Quick Send Key(剪贴板快速发送快捷键) 类型:按键/复合;默认:Ctrl+Alt+Add 说明:触发剪贴板快速发送的快捷键。建议避开编辑器、浏览器和游戏内常用快捷键,防止误触发。
- Clipboard Quick Send Confirm(剪贴板快速发送是否确认) 类型:布尔;默认:false 说明:开启后,同一段内容需要在确认时间内再次按下快捷键才会发送。适合担心误发、或经常用全选复制模式的场景。
- Clipboard Quick Send Confirm Time (s)(剪贴板快速发送确认限时,秒) 类型:数值;默认:5 说明:开启确认后,两次快捷键之间允许等待的时间。超过该时间会重新进入待确认状态。
- Clipboard Quick Send Prevent Repeat(剪贴板快速发送防止重复发送) 类型:布尔;默认:true 说明:阻止连续发送与上一条相同的剪贴板内容。保持开启可以减少重复按键、复制失败或焦点异常造成的刷屏。
- Clipboard Quick Send Apply Text Processor(剪贴板快速发送是否应用文本处理器) 类型:布尔;默认:false 说明:发送前先交给 ClipboardTweaks 的文本处理流程。需要自动替换、清理或格式化剪贴板内容时开启;如果希望原样发送则保持关闭。
- Auto Send Split Cooldown Min (ms)(自动发送切片冷却最小值,毫秒) 类型:数值;默认:1000 说明:当一段要发送的文本超过单条长度限制被拆分时,每段之间的最短等待时间。调大可降低连续发送被限制的概率。
- Auto Send Split Cooldown Max (ms)(自动发送切片冷却最大值,毫秒) 类型:数值;默认:2000 说明:拆分发送时每段之间的最长等待时间。模块会在最小值和最大值之间取等待时间,让连续发送不完全固定。
- Send Cooldown (ms)(发送冷却,毫秒) 类型:数值;默认:2000L 说明:弹幕发送队列的基础冷却。队列命令、自动回复或手动发送密集触发时会受它限制,避免过快连续发送。
- Prevent Others Room Chatter Sending(阻止向他人直播间发送弹幕) 类型:布尔;默认:true 说明:防止向非本人直播间发送弹幕的保护开关。观察别人直播间、调试 AI 回复或切换房间时建议保持开启。
- Max Allowed Chatter Delay (s)(弹幕延迟最大允许值,秒) 类型:数值;默认:60U 说明:丢弃过旧的直播间弹幕,避免网络恢复后把历史弹幕当作新消息显示、朗读或触发命令。
- Single Chatter Length Limit(单条弹幕长度限制) 类型:数值;默认:40U 说明:单条发送弹幕的长度上限。超过上限的文本会被拆分;过小会增加分段数量,过大可能超过平台限制。
- Color(颜色) 类型:枚举;默认:"White" 说明:普通弹幕以
Chatter方式显示时的颜色。直播背景复杂时建议使用高对比度颜色。 可选:见 NAMED_COLOR_BASE_LIST - Display(显示) 类型:枚举;默认:"Chatter" 说明:收到普通弹幕后的展示方式。
Chatter更像屏幕弹幕;Notify适合低频提醒;Title和Actionbar更醒目;Off只保留后续处理链路,不在界面显示。 可选:Off;Chatter;Notify;Title;Actionbar - User Filter (PRO)(用户筛选,PRO) 类型:枚举;默认:"All" 说明:限制哪些用户的弹幕进入后续显示、朗读、触发和 AI 流程。观众量大时可只处理粉丝、付费粉丝或舰长用户;非 PRO 只能使用
All。 可选:All;Fans;Paid Fans;Guard - User Filter (Bili Min Level) (PRO)(B 站最低等级筛选,PRO) 类型:数值;默认:2 说明:只处理 B 站等级达到该值的用户弹幕。可用于降低小号或临时账号对自动化流程的影响。
- User Filter (Wealth Min Level) (PRO)(财富最低等级筛选,PRO) 类型:数值;默认:0 说明:只处理财富等级达到该值的用户弹幕。适合把高价值观众的弹幕优先交给提醒、朗读或 AI 回复。
- User Filter (Medal Min Level) (PRO)(粉丝牌最低等级筛选,PRO) 类型:数值;默认:0 说明:只处理粉丝牌等级达到该值的用户弹幕。用于减少路人弹幕触发自动流程。
- User Filter (Exclude Default Names)(排除默认昵称用户) 类型:布尔;默认:false 说明:过滤仍使用平台默认昵称格式的用户。开启后可减少临时号或未个性化账号进入弹幕处理链路。
- User Filter (Exclude Non-vip Users)(排除非 VIP 用户) 类型:布尔;默认:false 说明:只保留 VIP 用户弹幕。适合高噪声直播间,但会显著减少可见弹幕量。
- User Name Display(用户名称显示) 类型:枚举;默认:"Default" 说明:控制弹幕里显示的用户名形式。
Default使用完整昵称;Head或Head + Tail适合隐私化展示;UID便于排查用户;Netease Nickname用于联动网易云昵称。 可选:Default;Head;Head + Tail;UID;Netease Nickname - Horizontal Reverse(横向翻转) 类型:布尔;默认:false 说明:让屏幕弹幕反向横向移动。通常保持关闭;如果你有特殊镜像布局或舞台投屏需求再开启。
- Actionbar Color(行为栏颜色) 类型:枚举;默认:"Colorful" 说明:弹幕以
Actionbar方式显示时的颜色。Colorful更醒目,固定颜色更利于保持直播画面统一。 可选:见 NAMED_COLOR_BASE_LIST - Title Color(标题颜色) 类型:枚举;默认:"White" 说明:弹幕以
Title方式显示时的颜色。Flow会使用动态颜色;固定颜色在复杂背景下更稳定。 可选:Flow;其余颜色见 NAMED_COLOR_BASE_LIST - Title Font Size(标题字号) 类型:数值;默认:150 说明:弹幕标题显示的字号。低分辨率或文字较长时应调小,避免遮挡画面;大屏投放可适当调大。
- Console Output(控制台输出) 类型:布尔;默认:true 说明:是否把弹幕输出到客户端控制台。适合调试过滤规则、AI 回复和触发器命中情况。
- Console Output Timestamp(控制台输出时间戳) 类型:布尔;默认:true 说明:控制台弹幕是否显示时间。排查延迟、回放日志或对齐直播事件时建议开启。
- Console Output Wealth & Medal(控制台输出财富值和灯牌) 类型:布尔;默认:true 说明:控制台弹幕是否附带财富等级和粉丝牌信息。需要观察用户分层或调试 PRO 筛选时保持开启。
- File Output(文件输出) 类型:布尔;默认:false 说明:是否把弹幕追加写入文件。适合交给 OBS、脚本、复盘工具或外部统计程序读取。
- File Output Format(文件输出格式) 类型:文本;默认:"
" 说明:写入文件时使用的格式模板。可使用、` 等占位符;默认用反引号分隔内容和昵称,便于脚本再解析。 - File Output Path(文件输出路径) 类型:文本;默认:"output\Chatters.txt" 说明:弹幕输出文件路径。建议放在
output或专门的直播工作目录,方便 OBS 和外部工具读取。 - User Whitelist Enabled(启用用户白名单) 类型:布尔;默认:false 说明:开启后只处理白名单用户的弹幕。适合只让房管、测试账号或固定观众触发自动化。
- User Whitelist (Sep With Semicolon)(用户白名单,用分号分隔) 类型:文本;默认:"Wormwaker;Worrnwaker" 说明:用户白名单,多个昵称用英文分号分隔。昵称需要与直播间显示名称匹配。
- User Blacklist Enabled(启用用户黑名单) 类型:布尔;默认:false 说明:开启后忽略黑名单用户的弹幕。适合屏蔽会触发刷屏、朗读或 AI 回复的特定用户。
- User Blacklist (Sep With Semicolon)(用户黑名单,用分号分隔) 类型:文本;默认:"" 说明:用户黑名单,多个昵称用英文分号分隔。命中后不会进入显示、朗读、触发器和 AI 回复流程。
- Custom Filter Enabled(启用自定义过滤器) 类型:布尔;默认:false 说明:开启后按自定义关键词过滤弹幕。适合拦截直播间不希望展示或触发的特定词。
- Custom Filter Keywords (Sep With Semicolon)(自定义过滤器关键词,用分号分隔) 类型:文本;默认:"" 说明:自定义过滤关键词列表,多个关键词用英文分号分隔。命中后弹幕会被视为非法内容并替换为过滤提示。
- Taboo Filter(违禁词过滤) 类型:枚举;默认:"Replace (Unsafe)" 说明:控制内置敏感词处理方式。
Block直接丢弃;Filtered用过滤提示替代;Replace (Unsafe)会尝试替换文本后继续处理,可能保留部分语义,因此标记为不安全。 可选:Off;Block;Filtered;Replace (Unsafe) - Remote Execution (Riskful)(远程执行,有风险) 类型:枚举;默认:"Disabled" 说明:允许直播弹幕触发远程命令执行。该能力风险很高,只有明确需要并已配置白名单、权限策略和测试房间时才应开启。 可选:Disabled;Wormwake
- Remote Execution Username Whitelist (Sep with Semicolon)(远程执行用户名白名单,用分号分隔) 类型:文本;默认:"Wormwaker;Worrnwaker" 说明:允许触发远程执行的用户名列表。即使开启远程执行,也应只放可信账号。
- Remote Execution Privileges Policy(远控权限策略) 类型:枚举;默认:"Admin & Normal" 说明:决定远程执行命令以管理员权限还是普通权限处理。
Everyone Admin风险最高;Only Admin最保守;默认让白名单用户使用管理员权限、其他允许用户使用普通权限。 可选:Everyone Admin;Admin & Normal;Only Admin;Everyone Normal - Remote Execution Display(是否显示远程执行信息) 类型:布尔;默认:false 说明:远程执行命中后是否继续把原弹幕作为普通弹幕显示。关闭时更像后台控制命令,开启时观众能看到对应文本。
- Remote Execution Notify(是否通知远程执行结果) 类型:布尔;默认:true 说明:远程执行后是否显示执行结果通知。调试和日常使用都建议开启,便于确认命令是否被触发。
- Speaker(讲述) 类型:枚举;默认:"Off" 说明:控制是否朗读收到的弹幕。
Username & Text会读昵称和内容;Only Text只读弹幕正文。直播间人数较多时建议配合白名单、黑名单或触发器使用。 可选:Off;Username & Text;Only Text - Speaker User Whitelist Enabled(启用讲述用户白名单) 类型:布尔;默认:false 说明:开启后只朗读白名单用户弹幕。适合只读房管、舰长或指定互动用户。
- Speaker User Whitelist (Sep With Semicolon)(讲述用户白名单,用分号分隔) 类型:文本;默认:"Wormwaker;Worrnwaker" 说明:讲述白名单昵称列表,多个昵称用英文分号分隔。
- Speaker User Blacklist Enabled(启用讲述用户黑名单) 类型:布尔;默认:false 说明:开启后不朗读黑名单用户弹幕。适合屏蔽刷屏用户或不适合 TTS 的账号。
- Speaker User Blacklist (Sep With Semicolon)(讲述用户黑名单,用分号分隔) 类型:文本;默认:"" 说明:讲述黑名单昵称列表,多个昵称用英文分号分隔。
- Translator(翻译器) 类型:枚举;默认:"Off" 说明:控制弹幕翻译方向。
Chinese将弹幕翻译为中文;English翻译为英文;Exchange在中英之间互换。需要可用的翻译服务配置。 可选:Off;Chinese;English;Exchange - Speaker Skip Emoji(讲述跳过表情) 类型:布尔;默认:true 说明:朗读时跳过表情文本,避免 TTS 读出大量表情代码。想完整朗读原文时可关闭。
- Speaker Async(讲述是否异步) 类型:布尔;默认:true 说明:异步执行朗读,减少 TTS 阻塞弹幕接收和界面刷新。遇到语音顺序异常时可关闭测试。
- Sound(音效) 类型:声音项;默认:Off 说明:收到弹幕时播放的提示音。适合低频直播间提醒;高频直播间建议关闭或只配合筛选使用。
- Triggers Enabled(启用触发器) 类型:布尔;默认:false 说明:开启后弹幕可按触发器配置执行命令。适合关键词互动、自动感谢、直播特效或联动其他模块。
- Trigger Disable Speaker(触发器禁用讲述) 类型:布尔;默认:true 说明:弹幕命中触发器后是否跳过朗读。保持开启可以避免同一条弹幕既触发动作又被读出造成重复干扰。
- Triggers Using Regex(触发器使用正则表达式) 类型:布尔;默认:true 说明:触发器匹配规则是否按正则表达式解释。正则更灵活,但错误规则可能误匹配大量弹幕;只需要普通关键词时可关闭。
- Triggers Config Path(触发器配置路径) 类型:文本;默认:"config\liveStreamChatterTriggers.ini" 说明:弹幕触发器配置文件路径。文件不存在或规则为空时不会触发;建议先用无风险命令验证匹配范围。
- Transform Emoji(转换表情) 类型:枚举;默认:"Character" 说明:控制弹幕中的表情如何转换。
Character转为可显示字符;Braces保留为括号样式文本;Off不做转换。 可选:Off;Character;Braces - AI Response(人工智能回复) 类型:枚举;默认:"Off" 说明:收到弹幕后是否让 AI 生成回复,以及回复输出到哪里。
Real Chatter会向直播间公开发送真实弹幕,启用前必须确认账号、房间和提示词都可靠。 可选:Off;Notify;Speak;Chatter;Title;Actionbar;Real Chatter - AI Response Chatter Type(人工智能回复弹幕类型) 类型:枚举;默认:"Top" 说明:AI 回复以
Chatter方式显示时使用的弹幕运动或位置类型。 可选:Scroll;Top;Bottom;Reverse;Horizontal;Vertical;Random - AI Response Chatter Color(人工智能回复弹幕颜色) 类型:枚举;默认:"Red" 说明:AI 回复以
Chatter方式显示时的颜色。建议与普通弹幕颜色区分,方便识别 AI 内容。 可选:见 NAMED_COLOR_BASE_LIST - AI Response Title Color(人工智能回复标题颜色) 类型:枚举;默认:"Red" 说明:AI 回复以
Title方式显示时的颜色。红色更醒目,但频繁触发时可能干扰直播画面。 可选:见 NAMED_COLOR_BASE_LIST - AI Response Prefix(人工智能回复前缀) 类型:布尔;默认:true 说明:是否在 AI 回复前加上前缀。开启后观众或主播更容易看出 AI 正在回复谁。
- AI Response Prefix String(人工智能回复前缀字符串) 类型:文本;默认:"回复@{user}:" 说明:AI 回复前缀模板。
{user}会替换为触发回复的用户名,可改成直播间自己的称呼风格。 - AI Response Prompt(人工智能回复提示词) 类型:文本;默认:"请用简要的语言回复这条直播间弹幕,最好不要超过20字,但是不要复述弹幕:" 说明:无上下文模式下发送给 AI 的提示词。应明确要求简短、可公开展示、不要复述观众原文。
- AI Response Prompt (With Contexts)(人工智能带上下文回复提示词) 类型:文本;默认:"请用简要的语言和直播间弹幕进行对话,每次你的输出一定不要超过40字,不要思考过程,不要复述用户的消息。下面开始对话。" 说明:上下文模式下的系统提示。适合连续互动,但应限制长度和风格,避免 AI 长篇输出或偏离直播语境。
- AI Response Cooldown (ms)(人工智能回复冷却,毫秒) 类型:数值;默认:5000L 说明:AI 两次回复之间的最小间隔。直播间弹幕密集时建议调大,控制请求量和回复频率。
- AI Response Contexts Enabled(人工智能回复启用上下文) 类型:布尔;默认:true 说明:是否保留最近弹幕和 AI 回复作为对话上下文。开启后回复更连贯,但会增加请求内容长度;不支持上下文的 AI 类型可能会自动降级。
- AI Response Contexts Limit(人工智能回复上下文限制) 类型:数值;默认:64 说明:保留的上下文条数上限。数值越大,AI 越能参考前文,但请求更长、成本和延迟也更高。
- AI Response User Blacklist Enabled(人工智能回复启用用户黑名单) 类型:布尔;默认:true 说明:开启后黑名单用户不会触发 AI 回复。适合排除测试账号、机器人账号或不希望 AI 回应的用户。
- AI Response User Blacklist (Sep With Semicolon)(人工智能回复用户黑名单,用分号分隔) 类型:文本;默认:"Wormwaker;Worrnwaker" 说明:AI 回复黑名单,多个昵称用英文分号分隔。默认排除示例账号,使用前可改成自己的测试号或机器人号。
- Experiemental At(实验性 AT) 类型:布尔;默认:false 说明:实验性的 @ 相关处理。除非正在测试直播间点名或回复链路,否则保持关闭。
历史更新
- 将 AutoLiveChatter 模块重命名为 LiveChatter,并将 LiveStream 模块的弹幕部分分到 LiveChatter 模块。重命名部分配置项。
- 添加模块:AutoLiveChatter,自动直播间弹幕。
备注
Real Chatter、自动发送、剪贴板快速发送和/blc都会向直播间公开发送弹幕。启用前确认当前Room ID、登录账号和保护开关。Developer.Live Chatter Fullwidth Spaces会影响手动命令发送路径中的空格处理;需要控制半角/全角空格时请到 Developer 模块配置。- 远程执行默认关闭。开启前建议先用测试房间、白名单账号和无破坏命令验证完整流程。
- AI 回复依赖 AISettings 或相关 AI 服务配置;上下文可用性取决于当前 AI 类型。
相关命令
/blc <content...>:向当前 LiveStream 房间发送一条 B 站直播弹幕,是/bili live chatter的快捷命令。/bili live chatter <content...>:向当前直播间发送弹幕,会进入发送队列并受冷却、长度拆分和房间保护影响。/bili live addchatter <room_id> <content...>:向指定房间追加一条待发送弹幕,适合脚本或外部流程指定房间投递。/bili live leetchatter <content...>:使用直播弹幕发送接口发送内容,适合需要直接测试发送链路的场景。/bili live cq list、/bili live cq show、/bili live cq display:查看当前弹幕发送队列。/bili live cq clear、/bili live clcq:清空弹幕发送队列。/bili live cq pause、/bili live cq resume:暂停或恢复弹幕发送队列。/bili live cq add <content...>、/bili live cq direct <content...>:向队列追加弹幕,或直接执行发送流程。/bili live switch <roomId> auto:切换到指定直播间并自动启用保护策略,适合观察别人直播间。/bili live switch back:切回自己的直播间。/livestreaminfo:查看当前直播间信息,便于确认房间号和连接状态。/chathistory clear livestream:清空直播弹幕 AI 回复上下文。/config list livechatter:列出 LiveChatter 当前配置,便于核对生效值。
相关模块
- LiveStream (直播间):提供房间号、直播间连接、礼物和观众数据,是 LiveChatter 的主要数据来源。
- BiliSettings (B站设置):提供 B 站登录状态,发送弹幕和账号操作需要它。
- ChatBar (聊天栏):可与直播弹幕输入和聊天显示联动。
- ClipboardTweaks (剪贴板增强):为剪贴板快速发送提供文本处理能力。
- AISettings (AI设置):配置 AI 回复、预设内容生成和部分接龙能力所需的 AI 服务。
- AutoTranslate (自动翻译):提供弹幕翻译所需的翻译链路。
- GALOptions:可接收直播弹幕作为剧情或互动输入。
- Streamer (主播模式):直播场景下常配合使用,减少主播端干扰。
- Developer (开发者):包含
Live Chatter Fullwidth Spaces等影响弹幕发送细节的调试配置。 - NAMED_COLOR_BASE_LIST:颜色配置可选值说明。
相关资料
无