[toc]

神奇弹幕以直播间为平台，利用网络通信技术、音视频技术、智能控制技术将直播有关的功能集成，构建高效的现代化播出环境与观众互动的管理系统，提升直播亲密性、便利性、艺术性，并提供全方位的信息交互功能。通过网络化综合智能控制和管理，实现“以人为本”的全新直播体验。

整合弹幕姬+答谢姬+点歌姬+回复姬+工作流(workflow)，支持弹幕聊天、观众互动、自动点歌、数据统计、私信处理等。最大的特点是可编程控制，自由制定规则，蕴含无限可能！

本程序以打造自动化直播间为主线，以建设高粘性粉丝团体为目标，坚持办好每一场直播、帮助每一名主播，保持观众互动，实现粉丝裂变，打造直播高峰，做有温度的直播助手。与此同时，规范观众行为秩序，促进直播产业健康有序发展，营造清朗的网络环境。

QQ群：1038738410，欢迎交流反馈与研究新功能~

• 主播秘书，一键上播下播、修改分区，直播数据收集与整理
• 根据约束条件（时间、等级、勋章等），按条件智能欢迎/答谢
• 外语自动翻译、AI闲聊回复、生僻字读音等自动化功能
• 粉丝变化、热门榜、大乱斗、船员变化、新人发言等种种数据
• 大乱斗查看双方串门的粉丝、同步视频PK对面消息、跑骚抓人
• 私信处理、感谢分享、最佳助攻、打卡回复、语音播报等
• 全自动点歌、弹幕切歌、自动暂停其它音乐、排队时长提示
• 点歌姬自动切换网易云/QQ/咪咕/酷狗，支持会员与本地导入
• 完全无人值守，远程控制，开播QQ群播报、自动录播
• 播放各音乐平台会员歌曲，没有版权的歌曲自动更换播放源
• 单个粉丝设置特别关心、强制提醒、专属昵称、永久禁言等
• 查看每名观众进来次数、礼物总计、弹幕记录、判断机器人等
• 弹幕语音播放与回复，百度/讯飞/微软语音等多个接口
• 小窗闲聊、迷你视频、快速截图，上班摸鱼挂后台听直播必备
• 自动签到、参与天选、领取小心心、赠送到期礼物
• 大量可编程运算、网页访问，超高自由度的弹幕机器人
• 游戏设计，比如扣1禁言、关注解禁、送礼物优先点歌等
• 更多神奇的隐藏功能，用户自己开发定制或者导入已有扩展

• 自动欢迎进入
• 自动感谢送礼
• 实时感谢关注
• 冷却避免刷屏
• 合并礼物连击
• 设置礼物别名
• 智能昵称简化
• 目标强制欢迎
• 舰长单独欢迎
• 自动语音播报
• 个人专属昵称
• 开播下播提醒
• 可编程变量集
• 动态条件运算
• 黑白名单筛选
• 支持远程控制
• 支持语音朗读
• 礼物总结答谢
• 答谢分享直播间
• 答谢PK最佳助攻
• PK对面信息播报
• PK在线舰长播报
• PK连胜数量播报

• 实时显示弹幕
• 小窗弹幕聊天
• 定时弹幕任务
• 简约聊天模式
• 点歌自动复制
• 查看点歌历史
• 保存弹幕历史
• 每日数据统计
• 外语自动翻译
• 智能沙雕回复
• 特别关心高亮
• 查看粉丝牌子
• 查看礼物价值
• 查看昵称拼音
• 粉丝变化提示
• 房管一键禁言
• 新人发言提示
• 弹幕自由复制
• 定时连接后台
• 喷子自动拉黑
• 新人快速禁言
• 跳转用户主页
• 用户累计数据
• 用户弹幕历史
• PK 历史次数
• 快速百度搜索
• 大乱斗的串门
• 对面消息同步
• 机器小号判断
• 弹幕语音朗读
• 支持讯飞语音
• 支持语音接口
• 弹幕全屏滚动
• 背景图片轮播
• 自动切换勋章
• 发送对面弹幕
• 显示船员数量
• 屏蔽用户进入
• 屏幕天选弹幕
• 发弹幕表情包

• 音源自动切换
• 播放会员歌曲
• 网易云ID点歌
• 点歌自动播放
• 智能匹配歌曲
• 暂停其余音乐
• 点歌历史记录
• 自由显示格式
• 自动点歌队列
• 点歌防止刷屏
• 关键词黑名单
• 伴奏优先播放
• 预计时长回复
• 支持弹幕切歌
• 送礼立即播放
• 背景封面模糊
• 提取主题色调
• 查看桌面歌词
• 收藏夹与历史
• 一键导入歌单
• 导入本地音乐

• 修改房间标题
• 一键开播下播
• 切换直播分区
• 直播数据展示
• 实时人气查看
• 每日平均人气
• 一键任命房管

• 自动开始录播
• 分割文件大小
• 断联自动重录

• 自定义关键词
• 筛选用户条件
• 多条随机回复
• 支持编程变量
• 数量不做限制
• 用户弹幕打卡
• 远程控制程序
• 修改专属昵称
• 弹幕文字替换
• 每日天气预报
• 解析用户私信

• 匿名查看直播
• 预先连续截图
• 预览PK对面
• 避免PK黑屏
• 自动调整比例

• 快速预先截图
• 多图片管理器
• 好图一键提取
• 截图批量裁剪
• 分解GIF动图
• 制作GIF动图
• 制作AVI视频
• 制作字符画图

• 直播姬可访问
• 无限扩展可能
• 支持B站接口

• 开启大乱斗
• 全局快捷键
• 保存头像封面
• 配置导入导出
• 数据自动备份
• 投稿歌词字幕
• 自动切换勋章
• 每日自动签到
• 自动参与天选
• 赠送到期礼物
• 直播状态查询
• 直播匿名跑骚
• 捕捉黑听舰长

绿色版，免安装，双击 神奇弹幕.exe打开。

退出从屏幕右下角托盘的右键菜单中退出。

下载新版的zip文件，解压后将里面的文件复制，覆盖旧版的文件。

复制整个安装文件夹即可，支持任意多开。

默认就是绿色版，无限多开，可放在U盘等移动介质上。

删掉程序同一目录下的“green_version”文件，即变成安装版，不同位置的神奇弹幕使用同一套数据。

绿色版，开箱即用，输入房间号自动连接。

实时弹幕支持如同聊天软件的水群小窗，Shift+Alt+D快速弹出（非隐藏时有效），ESC返回之前的程序。

右键菜单中有许多的操作，可自行研究。

若是上班摸鱼，可以设置闲聊模式（仅显示弹幕）+简约模式（去头像、彩色），背景全透明，文字半透明灰色，不注意绝对很难看出来。

如果要发送弹幕，必须登录账号。目前有二维码登录和手动设置Cookie两种方式。

方式一：二维码登录

直接点开菜单中的“账号——二维码登录”，使用哔哩哔哩APP扫码确认。

方式二：使用浏览器Cookie登录

1. 浏览器上按 F12打开【开发者工具】，Network - XHR
2. 进入或刷新B站主页（没登录的需登录），Name多了一排，点其中任意一个（若找不到Cookie就换个）
3. 复制如下图的cookie至右上角登录账号的菜单中的“设置Cookie”，即可进行发送。

使用Cookie也是为了保证账号安全，当程序借给别人时，自己可以远程退出Bilibili账号，所有登录失效。之后则需要重新设置cookie。

如果输入房间号后一直显示“获取房间信息...”，需先安装VC_redist：https://aka.ms/vs/15/release/vc_redist.x64.exe

在“答谢”/“扩展”页的右上角按钮，点出“自定义变量”，添加当前主播的信息：

%upname%=小明

程序内置变量里的 %up_name% 会替换为主播的账号昵称，此处自定义的 %upname% 可以是完全不同的文字

代码中就可以使用 “欢迎%ai_name%来到%upname%的直播间~” 这样的格式。

几处代码框（欢迎/礼物答谢/关注答谢/定时/回复/事件/禁言等）按照以下格式：

[必须满足条件1]*****(发送选项)弹幕内容1\n第二条弹幕\n第三条弹幕
[必须满足条件2]***(发送选项)弹幕内容2
[必须满足条件3]*(发送选项)弹幕内容3

各部分分别是：

• 条件（带方括号）
• 优先级（星号，数量越多优先级越高）
• 发送选项（带小括号）
• 弹幕内容

各部分均可省略，但是若加上，则前后顺序不能换，并且必须使用英文符号。

如果一个代码框内有多行，则随机发送一行。多条弹幕需要在同一行，并且使用 “\n” 分隔。

具体说明在下一大章，可点击上方超链接快速跳转。

以下多项功能支持自定义弹幕、大量可编程变量，具体说明请参考下面的“可编程设计”。

• 普通的欢迎：%ai_name%，%greet%%tone/punc% 将发送：某某某，早上好啊~

• 欢迎舰长：[%guard%]*欢迎%guard_name% %ai_name% 回家~

• 一周至一个月没来：[%come_time%>%timestamp%-3600*24*30, %come_time%<%timestamp%-3600*24*7, 0]*%ai_name%，太久没来了哦~

  v3.5.7修改：为了保证运行效率，一周没有进入直播间的用户记录将自动清除

• 大乱斗对面来人：[%pk_opposite%]***欢迎%ai_name%串门哦~

未戴粉丝勋章或者不是本直播间粉丝勋章的用户，不自动欢迎；除非是舰长或设置为强提醒：

[%guard% = 0, %anchor_room_id%!=%room_id%, !%strong_notify%]**

两个 *表示优先级，覆盖没有 *或1个 *的弹幕，空弹幕表示不发送。

指定某一用户的进场通知：

[%uid%=12345678]***欢迎%ai_name%，说好的今天上总督呢~
[%uname%=用户昵称]***欢迎%ai_name%，今天记得上总督哦~

推荐使用UID的方式，不会变更；临时用可用uname。

其中表示优先级的 *数量务必要比其余弹幕多。

• 普通的答谢：谢谢 %ai_name% 的%gift_name%~
• 小礼物不理：[%gift_gold%=0, %gift_silver%<1000, %gift_num% < 10]** 也可以写作：[%coin_type%=0, %gift_coin%<1000, %gift_num% < 10]** 1000以下的银瓜子礼物且数量小于10，则忽略。例如忽略6个小心心，但24个小心心则感谢
• 超过80元的礼物：[%gift_gold%>=80000]*哇噢！感谢 %ai_name% 的%gift_name%！\n老板大气！！！！！！ \n表示换行，将分作两条弹幕发送（可以配合 <h1>放大字体，仅部分弹幕插件有效）
• 跳过机器人送的吃瓜：[%uid%=%my_uid%,%origin_gift_name%=吃瓜]**

赠送小电视飞船，发送指定弹幕：

[%gift_name%=小电视飞船]**哇！！！谢谢%ai_name%带大家上太空~

提升优先级，空弹幕，即屏蔽。

[%blocked%]****

[%special%]*(cd21:0)谢谢%ai_name%的特别关注！
感谢 %ai_name% 的关注%punc%

测试时不答谢关注的一个重要原因，是因为刚取消关注就重新关注了，短期内不会答谢！

定时发送随机弹幕、执行命令。

[%today_guard%=0]今天XX等到新的舰长了吗？\n老板们救救可怜的XX吧~
[%today_guard%>0]今天XX等到了新的舰长，还有老板想上船嘛

今天的相关数据都需要在程序连接房间时才有效

如果想要定时向某个API发送数据，可通过定时任务结合 connectNet(url)命令

>connectNet(要发送数据的网址)

比较不同时候的屏幕显示内容是否一致。

添加保存的代码，需要手动点击发送：

>saveScreenShot(0, 100, 100, 200, 200, D:/test.png)

该代码会把矩形 (100, 100, 200*200) 这个范围的截图保存到 D:/test.png 的位置。

添加定时 1 秒，代码：

[%>compareScreenShot(0, 100, 100, 200, 200, D:/test.png)% == 100]*>localNotify(相同)

>localNotify(不相同，相似度：%>compareScreenShot(0, 100, 100, 200, 200, D:/test.png)%)

%>compareScreenShot(0, 100, 100, 200, 200, D:/test.png)% == 100 的意思是将当前 (100, 100, 200*200) 的截图和之前保存的截图进行比较。

如果显示内容没变，则会打印出“相同”的文字。相似程度从 0 到 100，按像素进行比较，0 为完全不同，100 为完全相同。

有多种算法，并且支持不同参数：

• 按 pixel（默认）：压缩到 8×8 大小后逐一按像素比较 compareScreenShot(screenId, x, y, w, h, path, pixel) 返回 0 ~ 100 整数的相似度，越高则越趋于相同。
• 按 pixel 与一定范围内的差值 compareScreenShot(screenId, x, y, w, h, path, pixel, threshold) 其中 threshold 为 0 到 255 之间的整数，两张图相同位置的 R/G/B 差值在阈值内的视为同一个点。 返回 0 ~ 100 整数的相似度，越高则越趋于相同。
• AHash compareScreenShot(screenId, x, y, w, h, path, ahash) 返回 0 ~ 64 整数的相似度，一般当 >= 60 的时候可视为同一张图。
• DHash compareScreenShot(screenId, x, y, w, h, path, dhash) 返回 0 ~ 64 整数的相似度，一般当 >= 60 的时候可视为同一张图。
• PHash compareScreenShot(screenId, x, y, w, h, path, phash) 尚未实现

接收到某个关键词，发送对应的回复。

关键词支持正则表达式，使用 %$x%来获取匹配到的文本，其中 x为索引，%$0%为接收的整条弹幕，%$1%为捕获的第一对括号中的文字，%$2%为第二对，下同。

有专门的禁言选项卡，此示例仅仅是展示使用方式

添加需要禁言关键词 xxx，支持正则表达式。设置回复：

>block(%uid%)

默认仅主播与机器人账号支持弹幕禁言，此方法可提升至房管（或其他特定条件用户）：

添加回复：^((禁言|解禁|解除禁言|取消禁言) .+|撤销禁言)$，添加动作：

[%admin%]>execRemoteCommand(%text%)

添加表达式：别这么热情，添加回复：

>ignoreWelcome(%uid%)\n>已关闭您的自动欢迎

只要弹幕中包含“别这么热情”，则以后都不会自动欢迎

添加自动回复表达式：^请?叫我\s+(.*)$，添加回复：

>setLocalName(%uid%, %$1%)\n>设置您的专属昵称为：%$1%

当用户发送弹幕：“叫我 小明”或“请叫我 小明”，程序自动设置其专属昵称为“小明”。

可以使用 %local_name% 或者 %ai_name% 获取。

添加自动回复表达式：叫(\S+)\s+(.*)，添加回复：

[%admin%]>setLocalName(%(%$1%)%, %$2%)\n>修改专属昵称成功

开启“扩展—网络服务”，之后于直播姬中添加浏览器并访问网址，即可打开插件页面，无缝嵌入直播界面。

网址为：http://localhost:5520 + 路径。

目前支持以下功能：

例如点歌列表，默认的链接是：

http://localhost:5520/music/index.html

更多功能可自行定制，接口与开发文档见底部“Web开发接口”。

主播或者机器人账号在直播间内发送如 关闭欢迎、开启录播等命令，可远程控制在服务器上的机器人（本地没必要使用远程命令）。

• 关闭/开启功能：主开关
• 关闭/开启欢迎
• 关闭/开启关注答谢
• 关闭/开启送礼答谢
• 关闭/开启禁言：新人关键词自动禁言
• 关闭/开启点歌
• 关闭/开启点歌回复
• 关闭/开启定时任务
• 关闭/开启自动连接
• 关闭/开启AI回复：AI回复弹幕
• 关闭/开启录播
• 禁言 [昵称] [小时]：房管权限，根据[昵称]（允许一部分，根据弹幕记录自动倒找发言人）禁言某用户，[小时]可省略，默认为自动禁言的时长（禁言相关都需要在设置中开启“启用禁言（主播/房管）”）
• 解禁 [昵称]：解除禁言，[昵称]支持用户名中的一部分
• 撤销禁言：依次解禁最近禁言的用户
• 永久禁言 [昵称]：永久禁言某用户，可通过“解禁 [昵称]”、“撤销禁言”远程解除
• 关闭机器人：全局关闭（将无法远程唤醒）

支持自定义实时弹幕的CSS样式，实时弹幕的右键菜单中，设置->标签样式。

圆角矩形

background: white;
padding:5px;
border-radius: 10px;

气泡图片

padding:10px;
border-image: url(:/bubbles/bubble1)

其中图片可使用本地绝对路径，例如：

border-image: url(C:/Path/To/Image.png)

类型选择

支持按不同类型设置不同的样式，样式如下：

• msg：一些提示
• danmaku：弹幕（样式不影响左边头像显示）
• gift：送礼
• welcome：进入
• order-song：点歌提示文字：[点歌] 歌名
• guard-buy：开通/续费舰长
• welcome-guard：舰长进入
• attention：关注
• block：禁言
• share：分享直播间
• super-chat：醒目留言

以下是一个示例：

弹幕为默认气泡；礼物、上舰为圆角矩形卡片

#danmaku {
    border-image: url(:/bubbles/bubble1);
    padding: 10px;
}
#gift, #guard-buy {
    background: #FFDAB9;
    padding: 5px;
    border-radius: 10px; 
}

本程序支持无限多开，在程序根目录下创建“green_version”文件，即是绿色版（默认），不同文件夹中的神奇弹幕使用不同的数据。删除文件夹时，程序及其使用数据将全部删除，不会留下痕迹。

若未设置成绿色版，则不同文件夹的神奇弹幕使用同一套数据，多开可能会有冲突。删除文件夹时，使用数据不会删除。此时升级很方便，新下载的安装包删除“green_version”即可恢复之前数据。

每次启动的时候会将程序配置（settings.ini）和使用数值（heaps.ini）各加上当前时间备份至“backup/”文件夹，若不小心被其他版本覆盖，可将备份的这两个文件去掉文件名中的时间，放到程序根目录下。

如果经常遇见问题，请按以下方法开启日志：

在程序根目录的 settings.ini 文件中， [runtime] 分组下（没有则自己新建），添加 debugToFile=true。

重启神奇弹幕，根目录下会出现 debug.log，这就是调试日志。

盘查问题时需要将这个文件交给开发者。

通过一系列用户自由设计的代码规则，将工作分解成定义良好的任务，制定其触发条件和执行顺序，按照一定的规则和过程来执行这些任务，这就是工作流。

直播间实施工作流管理所带来的好处是非常明显的，这包括提高直播间运营效率、改善人气资源利用、提高直播运作的灵活性和适应性、提高工作效率、集中精力处理弹幕聊天、跟踪观众互动过程、量化粉丝粘度、统计礼物数量，充分发挥现有直播数据的作用。实施工作流将达到缩短互动等待周期、改善弹幕流程、优化并合理利用资源、减少人为差错和延误、提高吸粉效率等目的。

总结可编程工作流带来的好处，可以归纳为以下几点：

1. 要处理的事项自动回复
2. 不需要对观众的数据进行手动整理
3. 主播只需要将精力集中在关心的互动上
4. 保存所有历史记录
5. 随时看到统计数据
6. 达到无纸化办公的目标
7. 完全支持分布式架构，多设备同时工作
8. 科学管理更近一层，直播效率明显提高
9. 直播间的核心竞争力将有所提升
10. 通过流程自动化与数据库集成，以及各类表单统计查询功能，提高决策能力

工作流的实现需要三个基本步骤：映射、建模和管理。映射是第一个步骤，其首要任务是确定直播间内全部现有的手工和自动化的业务流程；建模则是开发一个有助于与观众交互的模型。第三阶段是软件实施以及跨越多项业务逻辑的无缝系统集成。

为了确保工作流系统能够无缝地衔接到直播间中，用户必须遵从已经定义好的、经过实践确认的行之有效的脚本规则，并且在每个脚本都必须有可以度量的结果。在实际使用中，根据主播的情况来制定符合要求的脚本，在易用性和功能需求之间达到平衡。

弹幕的候选列表中，支持一系列的可编程变量、简单逻辑运算、简单算术运算。

使用两个 % 包括的英文，则为变量。数据变量例如 %uname%，与当前的一系列数据相关，例如礼物价值、今日人数等等；招呼变量例如 %greet%，自动替换为当前时间段对应的招呼语，例如候选项表达式 %ai_name%，%greet%%tone/punc%，在早上可能是“早上好啊，某某某”，在下午可能是“某某某，下午好~”，在晚上又会是“晚饭吃了吗，某某某~”。

示例：

• 简单的欢迎：欢迎 %ai_name% 光临~
• 动态语气词：%ai_name%，%greet%%tone/punc%

看下去，有更多例子。

如无特殊说明，下述代码的符号均以英文符号为准，如 []、()、,，不支持中文的 【】、（）、， 等。

在“扩展”页面，右上角的菜单中选择“自定义变量”，在打开的对话框中设置自己需要的变量。

每一行使用“变量名 = 变量值”，所有代码块中的变量名都会替换为变量值。

一般来说，默认包含以下变量：

• %upname%：主播昵称

这些自带变量可能会在自带的代码中出现，请务必修改。

同上，都需要带上百分号，例如 %var%，表格中皆省略。

目前已支持中文，可直接使用形如 %用户ID% 的格式。

仅在 定时任务、自动回复、事件动作 中有效，在开启“仅直播时回复”开关后，下播后所有自动弹幕都将不发送。

此时在需要发送的弹幕框中，其 任务/回复/动作中带有 %living%选项，则在非直播时也会激活。

例如自动回复的动作为：[%living%+1]弹幕文字，该回复不受直播状态影响。

如果开启了“定时连接B站服务器”，那么超出时间段下播后神奇弹幕不会接收所有弹幕，所有功能暂停。

%csrf%为用户cookie，用于连接B站的API，结合本程序的 connectNet(GET)、postData(POST)，向服务器发送指定数据。

%{key}% 如果是一个未设置的值，那么将会是空字符串，如果要转化为数字 0，可以使用 %[%{key}%+0]%的方式。

支持默认值，格式为：%{key|def}%，如果key不存在，则会使用def的值，可以是数字或者任意字符串。

谢谢%ai_name%赠送了价值%[%gift_gold%/1000]%元的%gift_name%！

按指定格式，获取动态的数值，格式：%>func(args)%

以获取时间为例：

当前时间：%>time(yy-MM-dd hh:mm)%

数字与数字、字符串与字符串之间可进行比较。其中运算符支持 加+、减-、乘*、除/(向下取整)、取模%、包含~，比较支持 大于>、小于<、等于=、不等于!=、大于等于>=、小于等于<=。

tips：

• 开发人员友好，= 可写作 ==
• 不等于 != 也可以是 <>
• 字符串两端可不用加双引号 "

比较的两边，当都是数字或算数表达式时，自动进行简单的计算（暂不支持复杂格式）。

另外，仅支持在开头的 []判断中进行四则运算，在弹幕内容中计算需要使用 %[公式]%！

所有变量的值都是在触发的一瞬间赋值的，如果在同一行中前面修改了某一值，那么后面的值也不会跟着修改。请看以下示例：

>setValue(count, %[%{count}%+1]%)\n数量：%{count}%

将数量count的大小加1并发送数量的弹幕，但显示的count是修改之前的大小。

应使用以下方式，计算两次：

>setValue(count, %[%{count}%+1]%)\n数量：%[%{count}%+1]%

另外，由于弹幕冷却时间，所有命令也不是瞬间执行完毕，会按照一定的时间间隔依次执行，可能会导致读取的时候前面命令还没写完。典型的例子就是多个人同时打卡，总次数只会增加一次（但不影响两个人的打卡天数、积分等）。

V4.6.0 版本开始，新增一项开关：语法糖，默认开启。

如果要修改一个值，以前的版本是比较复杂的，例如将打开天数+1：

>setValue(data, %[%{daka}%+1]%)

而通过语法糖，则只需要简单的相加即可：

{daka}++

目前开启此项功能后，可支持以下语法糖：

• 赋值：{var} = 20，等同于 >setValue(var, 20)
• 加/减/乘/除/取模：{var} += 10，等同于 >setValue(var, %[%{var}% + 10]%)
• 自增/自减：{var}++ 、{var}--，前者等同于 >setValue(var, %[%{var}% + 1]%)

与编程语言相似的算法，每一行使用 [] 开头，则方括号中的内容会识别为 条件表达式，使用 , 或 && 来执行“与”逻辑，使用 ; 或 || 来执行“或”逻辑；“或”的优先级更高。[] 中使用 %val% 作为变量值，例如 [%level%>10]弹幕内容，则只有当用户等级超过10级时才会被发送 弹幕内容。

（V4.0.6新增）当条件表达式包含字符串或者正则表达式时，可能会出现符号冲突问题，使用双方括号 [[条件]] 或者三方括号 [[[条件]]] 来替换单方括号。

示例：

• 用户等级为0级：[%level%=0] 或 [%level% == 0]
• 粉丝牌等级介于10级到19级之间：[%medal_level%>=10, %medal_level%<20]
• 名字为某某某：[%uname%=某某某] 或 ["%nickname%"=="某某某"]
• 现在是黑夜：[%time_hour% > 17 || %time_hour% <= 6]
• 带粉丝牌的0级号，或非0级号：[%anchor_room_id%, %level%]
• 付费两万（2千万金瓜子）的老板：[%total_gold% >= 20000000]
• 一小时内重新进入直播间：[%come_time% > %timestamp%-3600]
• 几周没来：[%come_time%>%timestamp%-3600*24*30 && %come_time%<%timestamp%-3600*24*7]
• 某个片哥名字匹配：[[%text% ~ "[\u4e00-\u9fa5]+[\w]{3}[\u4e00-\u9fa5]+"]]>block(%uid%)

文本框中内容支持多行，一行为一条候选项，随机发送一条。其中每一条都可以用星号 * 开头（若有条件表达式 [exp]，则 *位于表达式后面），星号数量越多，则优先级越高。高优先级候选应当带有条件，当满足条件时，发送该条弹幕，并无视掉所有更低优先级的候选。

带有优先级的候选项，会被更高优先级（更多星号）的候选项所覆盖。

例如：

感谢 %ai_name% 的%gift_name%，么么哒~
[%gift_gold%>=10000]感谢 %ai_name% 的%gift_name%，老板大气！
[%gift_gold%>=50000]*(cd15:3)哇塞！感谢 %ai_name% 的%gift_name%！\n老板大气！
[%gift_gold%>=150000]**(cd16:1)哇噢！感谢 %ai_name% 的%gift_name%！\n老板大气！！！！！！

注意星号，1、2无优先级，即使满足第2项的条件，也是随机发送前两项之一。3优先级超过1、2，因此当满足3的条件并且不满足4时，会发送第3项。而当4的条件满足时，其余更低优先级的候选项都被无视，只发送4。

另外，3、4加入了 冷却通道，表示不使用默认的送礼冷却。以4为例，改为冷却1秒，相当于强制发送（B站限制，最快1秒）。

• 当本次礼物的金瓜子总价少于1万时，发送第一项；
• 当本次礼物的金瓜子总价小于5万时，随机发送第一项、第二项；
• 当本次礼物金瓜子总价介于5万到15万时，发送第三项；
• 当本次礼物金瓜子总价超过15万时，发送第四项。

高优先级只是说明“在当前情景下更适合”，并不代表一定会发送这一条。

当这一条弹幕的字数超过了设置的“弹幕最长长度”，那么高优先级的弹幕会被忽略，转而发送低优先级的。

至于冷却通道，则不会影响优先级。当最高优先级的弹幕尚在冷却中时，不会发送弹幕。

使用 // 作为注释符号，直至后面行尾或者弹幕结束标记 \n，在发送弹幕时将被忽略。

使用 /// 作为显眼的注释说明，将会是高亮的颜色，而不是灰色。

也支持多条连续弹幕插入注释，如下：

// 单行注释，不会被发送
这是弹幕 // 弹幕后面的注释
第一条弹幕//中间的注释1\n第二条弹幕//中间的注释2\n第三条弹幕

在行尾使用 \ 可拼接连续的两行，不影响发送内容，示例如下：

计算结果：%[1     \
			+2  \
			+3]%

使用 \n 来分割过长弹幕，则会分多条弹幕发送，每次延时1.5s。通过此方式支持执行多条命令。

这是两个普通字符，并不是换行符。对于编程人员来说，相当于代码中两个反斜杠加字母n。

受于B站后台的限制，多条弹幕将调整为每隔1.5秒发送一次，数量无上限。

在发送的弹幕前添加英文小括号，里面可包含一些设置项 (option)，设置弹幕发送这一瞬间的属性。

• 冷却通道（cd）：控制弹幕发送频率
• 等待通道（wait）：控制自己不连续发送弹幕
• 强制房管权限（admin）：向普通观众的弹幕开放部分权限

举个例子：

[某条件]***(cd20:5,wait12:5)欢迎xxx~

发送选项必须在条件、优先级后面，顺序不能变动。多个发送选项使用英文逗号隔开。

这里以冷却通道为例：

• 条件的方式：[%cd20%>5]某弹幕
• 选项的方式：(%cd20%:5)某弹幕

同样是判断冷却通道20号的时间有没有满5秒，当满5秒的时候，两者的行为是一致的，都将发送弹幕。

若没到5秒，两者也都不会发送弹幕，但是具体影响上会有一些区别：

• 条件：会判断其他行的弹幕会不会发送，如果可以，则发送出去；
• 选项：不会判断其他弹幕，直接不发送。

条件用来判断发送哪些弹幕，选项用来控制弹幕发送频率。

选项中添加 admin 参数即可，如：

[%medal_level% >= 30](admin)>triggerReply(某回复)

该选项是用来提升普通用户的权限，即使不是房管，也可以使用一些相同的权限。

此处设置的权限仅用于代码块中的 %admin% 判断，不影响具体房管身份以及其他权限。

此处设置的房管权限可通过 >triggerReply() 和 >triggerEvent() 传递到其他代码。

当然，也可以作为手动点“发送”按钮的一项调整。

v2.9.0版本新增

为实现不同条件使用不同的冷却时间，新增了”冷却通道“的规则——连续发送弹幕（例如自动欢迎）会有一定冷却时间，但有时候会想要强制发送（例如强制欢迎舰长），或者自定义部分冷却时间（例如在有人连刷小心心的时候，突然有人上船，应当想要立刻通知）。

格式：cd通道:冷却秒数

在自定义弹幕的开头使用形如 (cd25:10)的格式，表示 现在如果在上次发送的冷却通道25号的弹幕10秒之后，则发送当前弹幕，即满足其10秒的冷却时间，并不受其他自动弹幕的影响。

每30秒欢迎一次用户；而若有25级及以上粉丝牌的用户进来，立刻欢迎，除非连续两个25级及以上的用户在5秒内进来，则只欢迎前一人；若是舰长，同上，多条冷却通道之间互不影响。而25级舰长，根据舰长优先级 **超过25级优先级 *，会优先发送欢迎舰长的弹幕。

(cd10:30)欢迎%ai_name%~
[%medal_level%>=25]*(cd11:5)欢迎%ai_name%，请多多关照~
[%guard%]**(cd12:5)欢迎舰长%ai_name%回家！

内置100个冷却通道，其中 0~9已被系统使用，用户自定义建议为 10~99，应该够用了。

注意：B站连续发送弹幕的冷却时间为1秒，与本程序的弹幕冷却系统无关。

针对指定某个通道的弹幕，机器人发送一条后，至少等待他人的多少条弹幕后才会重新发送这条弹幕；自己发送的弹幕不会包含在这“多少条弹幕”之后。

格式：wait通道:弹幕数量

通道与冷却通道一样，可选 0 ~ 99。不同的通道互不影响。

在程序一开始连接上直播间时，所有等待通道的值为 99，相当于 waitX:99，一般无影响。

如定时消息：

(wait12:3)某定时发送的弹幕

自动发送一条弹幕后，并且第一条和第二条弹幕之间至少有3条弹幕；不满足条件则不会发送出去。

因为有主播嫌弃机器人话多，专门加的功能。

结合条件和选项，设置定时任务，机器人不连续发送两条弹幕：

[%wait10% < 1]**** // 没有别人发弹幕时，自己不连续发弹幕
(wait10:0)喜欢%upname%的小伙伴可以动动小手点个关注~
(wait10:0)关注主播不迷路,主播带你上高速~
(wait10:0)喜欢主播的可以点点关注哦~
(wait10:0)赠送一个B坷拉，领取主播专属勋章哦~

通过条件 %wait10% < 1 先判断该等待通道能否发送，这样影响的是这一块代码中的所有弹幕；

至于 (wait10:0)，则只是标记这些弹幕的等待通道是 10，用于下一次的条件判断。

有一些自定义的命令，如 >block(123456)，如下：

在自动回复的每一条弹幕中使用符号 > 开头，紧接着 func(arg...) 格式，将执行命令，而不发送弹幕（若不是上述命令，将改为弹幕发送）。

注意：若要同时操作多个命令，可用 \n 隔开（相当于多条弹幕）

针对 setValuesIf(exp, [condition], newVal) 、removeValuesIf(exp, [condition]) 这两个较为复杂的命令。

exp为正则表达式，将会操作所有key满足该表达式的配置。

当且仅当在 [condition]中：

• _VALUE_替换为当前遍历到的值(value)
• _$x_替换为exp正则捕获的文字，其中 x=0时为键(key)，x>0时为正则的捕获组，等同于自动回复中的 %$x%
• _{key}_ 替换为读取配置文件，等同于正常情况下的 %{key}%

当且仅当在 newVal 中：

• _[exp]_替换为计算表达式（不支持外面再嵌套任意内容）

例如：

• 删除7天没来的用户记录： removeValuesIf(not_come_(\d+), [_VALUE_>7])
• 今日没签到的用户重置连续签到为0： setValuesIf(signin_keep_(\d+), [!_{signin_today__$1_}_], 0)
• 用户上船天数+1： setValuesIf(guard_days_\d+, [1], _[_VALUE_+1]_)

showValueTable(caption, key, field1, field2, field3...)

显示一个对话框，列出所有需要的值。

caption 是最顶上的标题，支持变量。

key 为用来遍历的带有可变值的正则表达式，例如 integral_(\d+)，将会遍历所有使用 setValue存储的键满足这个表达式的数值。其中必须有带括号的捕获组形如 (\d+)作为变化的源头，用来影响所有 field的变化；而在各 field 中可以使用 _KEY_ 或者 _ID_ 来替换为该值。

field 允许多个，每个的格式为：标题:键，标题是表格的标题（第一行），键是用来读取响应设置的。标题及中间的冒号可忽略。用 _KEY_ 或 _ID_ 来替换为表达式中变化源。单个数字类型的 field 末尾允许用 :< 从小到大、:> 从大到小排序，详见下方示例。

在 key和 field中，可使用 _counts/、_heaps/ 前缀来指定读取哪一个配置文件，key默认为 _heaps即用户自定义的配置；field默认跟随 key的配置。

其中，_counts/文件为 安装目录/danmaku_counts/房号.ini，自动保存每个直播间的数据，不同直播间不共享；_heaps/为 安装目录/heaps.ini，所有直播间共享一套数据。

显示签到的用户ID、昵称、积分，按积分从大到小排序

在之前的默认签到代码中，未加上保存昵称，所以uname是空的

>showValueTable(积分查询, integral_(\d+), ID:"_ID_", 昵称:uname__ID_, 积分:integral__ID_:>)

假定某个用户 id 是 123456，那么通过 integral_(\d+) 遍历到 integral_123456 ，则 _ID_ 是 123456，通过这一行来获取后面的 name_123456、integral_123456 等的值。

>showValueTable(今天共第%[%{daka}%+0]%人打卡, daka_sum_(\d+), ID:"_ID_", 累计:daka_sum__ID_:>, 昵称:uname__ID_, 积分:integral__ID_, 连续:daka_keep__ID_, 本月:daka_month__ID_, 今日:daka_today__ID_)

>showValueTable(氪金列表, _counts/gold/(\d+), ID:"_ID_", 金瓜子:gold/_ID_:>, 昵称:_heaps/uname__ID_)

三个联网命令：getData、postData、postJson，最后一个参数可带有一个“回调入口”。其实这是一个事件，添加该回调同名的事件，即可获取到联网返回的数据。

目前只支持JSON格式的返回数据，使用 %.键1.键2.键3% 这样的格式依次获取JSON对象的值，例如：

{
    "data": {
        "room": {
            "roomname": "房间名字"
        },
        "anchor": {
            "uname": "名字",
        }
    }
}

其中的roomname获取方式：%.data.room.roomname%，uname获取方式：%.data.anchor.uname%

注意：如果替换出来的内容包含换行，一样会替换到代码中，将会导致弹幕姬出错！

JSON容错处理

V4.0.4版本修改：当JSON对象没有该键或者索引超出数组范围时，默认还是原字符串（例如 %.data.list.1000%，原样发出）

如果要允许不存在的键或者超出范围的索引，可以在后面加上英文字符“?”，如：%.data.list?.1000?%，当没有list或者list数量不到1000时，会返回空白文本。“?”只影响单个键或者索引，例如若没有data，会原样返回 %.data.list?.1000?%，相当于报错。

这样的作用是，JSON的某些键可能是从变量中获取，需要先解析变量才能开始读取完整的JSON，而变量可能会出问题。

该版本之前，默认允许错误，返回空白。

添加命令至回复、事件等任意一项，动作：

>getData(https://api.live.bilibili.com/xlive/web-room/v1/index/getInfoByRoom?room_id=%room_id%, RoomInfoCallBack)

再添加一项事件：RoomInfoCallBack，动作：

>localNotify(舰长数量：%.data.guard_info.count%，\
	粉丝数量：%.data.anchor_info.relation_info.attention%，\
	粉丝团：%.data.anchor_info.medal_info.fansclub%，\
	主播等级：%.data.anchor_info.live_info.level%)

一般情况下，处理弹幕的命令会有短暂的延迟，尽管程序已经做了一定的优化，但两条弹幕前后的操作必定不会连续，存在 2s 延迟（受限于平台发送弹幕的最短间隔），因此如果同时处理多条弹幕，可能会出现数据丢失问题。

典型情况，如多人同时打卡，增加一天打卡次数：

观众1：>setValue(daka, %[%{daka}+1]%)
观众2：>setValue(daka, %[%{daka}+1]%)

假设 %{daka}% = 0，那么 %[%{daka}+1]% = 1 ，那么执行的命令有可能会变成：

观众1：>setValue(daka, 1)
观众2：>setValue(daka, 1)

虽然有两人打卡，但结束后 daka 的值依旧为 1，而不是 2。

修改方法：使用 >addValue(daka, 1) 或者语法糖 {daka}++ 来替代 >setValue(daka, %[%{daka}+1]%)，更安全且简洁易懂！

观众1：>addValue(daka, 1)  ->  变成1
观众2：>addValue(daka, 1)  ->  变成2

添加定时任务，设置时间为 86400 （一天秒数）

添加发送的文本：

>sendRoomMsg(直播间房号, 打卡)

例如：

>sendRoomMsg(123456, 打卡)

这个命令会在房号为“123456”的直播间发送弹幕“打卡”。

注意：需要关闭“仅直播时发送”，或加上条件 [%living%+1]（未开播也执行）

默认的设置只支持朗读用户名和弹幕内容，不能自定义朗读的格式。

这样设置自定义朗读的格式，加上“某某说”：

添加回复：(.+)，表示接收所有弹幕（不包括机器人自动发的），

>speakText(%uname%说：%text%)

注意：需要关闭设置里的朗读弹幕，否则会重复播放 2 遍

扣1禁言、关注主播或赠送小心心解除禁言（需要房管或主播）

回复中添加一栏，关键词为 ^1$，回复：

已自动禁言，赠送小心心或关注主播解禁\n>block(%uid%, 1)\n>addGameUser(%uid%)

这里执行了三个操作：

1. 回复
2. 禁言
3. 添加到游戏用户，等待解除禁言

答谢 — 感谢送礼中添加：

[%in_game_users%,%origin_gift_name%=小心心]***已解除禁言\n>unblock(%uid%)\n>removeGameUser(%uid%)

其中 [...]*** 中的星号为优先级，保证数量超过其余弹幕即可。

%in_game_users% 确保是扣 1 被禁言（因为禁言的时候添加到了游戏用户）的，而非被手动禁言的用户

答谢 — 感谢关注中添加：

[%in_game_users%]*已解除禁言\n>unblock(%uid%)\n>removeGameUser(%uid%)

实测已关注的，先取关再马上重新关注，收不到通知，需要等会儿再关注

在两个答谢中，执行了三个操作：

1. 回复
2. 解除禁言
3. 从游戏用户中移除，后续小心心不再触发该游戏，而是普通的答谢

答谢 — 感谢送礼中添加：

[%guard_buy%,%guard_first%=1]感谢%ai_name%开通%gift_name%！\n>sendPrivateMsg(%uid%, 感谢开通大航海，可加入粉丝群：xxx)

%guard_buy% 判断是否是购买舰长的通知；%guard_first% 判断是否第一次上船，第一次=1，续船=0，掉船后重新上船=2。

也可用 %guard_count% 来读取上船的次数作为条件，%guard_count%=0表示第一次上船。

%guard_count% 只计算本程序时运行时购买舰长的用户，每次舰长+1，提督+10，总督+100。

后续版本已添加 FIRST_GUARD 用户第一次上船事件，可直接使用。

答谢-感谢送礼中添加：

[%gift_name%=喵娘]>improveSongOrder(%uname%,5)

赠送一个喵娘则提前5首歌播放。可将 5改为 999表示无限大，或者用 %gift_gold% / 1000 表示每1000金瓜子礼物可提前一首歌，如下：

[%gift_name%=喵娘]>improveSongOrder(%username%,%[%gift_gold%/1000]%)

房管可以切所有歌，普通观众只能切自己点的歌

自动回复添加表达式：^切歌$

设置动作：

[%admin%]*>cutOrderSong()
>cutOrderSong(%uname%)

默认仅机器人和主播可远程控制，而其他人不行。通过此方法设置特定用户（例如舰长、房管）开关。

添加关键词表达式：^开启AI回复$

添加回复：

>execRemoteCommand(开启弹幕回复,0)\n>setValue(reply, 1)\n已开启AI弹幕回复，发送“关闭”结束

添加关键词表达式：^关闭(AI回复)?$（回复“关闭”两字即可，可不用全打）

添加回复：

[%guard%, %{reply}%]>execRemoteCommand(关闭弹幕回复)\n>setValue(reply, 0)

逐一说明：

• >execRemoteCommand：运行仅机器人和主播才能用的远程指令，参数2的 0表示不自动回复（因为有自定义的另一个回复，覆盖掉默认的）
• \n：多个指令或多条弹幕，用 \n 标记隔开
• setValue(reply, 1)：设置变量 reply的值为1，用来判断是否需要关闭
• [%guard%, %{reply}%]：舰长且 reply=1，若是则执行后面的，否则不做操作

添加回复：添加违禁词\s*(.+)，动作：

[%admin%]>addBannedWord(%$1%,|more_ban)\n>已设置，再发将自动禁言

违禁词格式：

^[^不都]*(违禁词1|违禁词2|more_ban)

在接收到房管发的形如“添加违禁词 笨蛋”的弹幕时，会在 |more_ban的左边插入 |笨蛋。

添加下述代码到任意可执行的地方，定时/回复/事件 均可，需要查看时点击“发送”按钮。

/// 显示所有用户积分
>showValueTable(积分查询, integral_(\d+), ID:"_ID_", 昵称:uname__ID_, 积分:integral__ID_:>, 动作:action__ID_, 坐骑:mount__ID_)

/// 显示所有打卡记录
>showValueTable(今天共第%[%{daka}%+0]%人打卡, daka_sum_(\d+), ID:"_ID_", 累计:daka_sum__ID_:>, 昵称:uname__ID_, 积分:integral__ID_, 连续:daka_keep__ID_, 本月:daka_month__ID_, 今日:daka_today__ID_)

收到服务器CMD消息、一些程序的运行状态的改变，都会触发本程序中的“事件”。

部分数据可直接用 %uid%、%uname% 等变量获得，部分CMD未读取数据，返回为空。

大部分CMD等同于B站后台CMD，也有一些是自创的。可用事件CMD如下：

禁言 xxx通过倒找弹幕发送人昵称的方法，通过弹幕禁言用户。其中所有属性同 DANMU_MSG，例如 %uid%、%uname%等。如果禁言对象是房管，那么将会禁言失败。

添加事件 REMOTE_BLOCK_OVERRIDE，添加动作：

[%uid%=%my_uid%]**>因为太帅无法被禁言
[%uid%=%up_uid%]**>已禁言主播（狗头保命）
[%admin%]*>无法禁言房管
>已禁言：%uname%

注意：添加本事件，将会屏蔽系统自带的禁言回复

如果想指定间隔准点发送，例如每15分钟，可在整点时开启时长为900秒的定时任务

NEW_DAY和 NEW_DAY_FIRST的异同：

同：

• 每天0点都会触发

异：

• NEW_DAY：如果神奇弹幕没开，那么第二天启动时需要手动点事件中对应的“发送”按钮
• NEW_DAY_FIRST：启动时会自动执行新的一天的操作

注意：v3.7.4版本之前，NEW_DAY_FIRST有 bug，每次启动都会触发

发送“签到”或“打卡”进行打卡，并回复第几个以及累计几天；每人每天只能打一次卡。

本处只做一个简单计数，建议使用下方的“高级打卡”示例

添加自动回复：^(签到|打卡)$，动作：

[%{daka_today_%uid%}%]*>您已打过卡
[%living%+1]>打卡成功，您是今天第%[%{daka}%+1]%个，累计%[%{daka_sum_%uid%}%+1]%天\n\
	>setValue(daka, %[%{daka}%+1]%)\n\
	>setValue(daka_today_%uid%, 1)\n\
	>setValue(daka_sum_%uid%, %[%{daka_sum_%uid%}%+1]%)

添加事件：NEW_DAY，动作：

[%living%+1]>removeValues(daka_today_\d+)\n>setValue(daka, 0)

[%living%+1] 是用来保证即使开启了“仅在直播时回复”也能发送回复的弹幕

在以上的打卡计数中，添加了：打卡查询、连续天数、每月累计天数、满足天数报告。

因数量较多，建议直接复制以下代码，使用“工具-菜单”中的“粘贴代码片段”一键添加。

[
    {
        "anchor_key": "神奇弹幕:AutoReply",
        "enabled": true,
        "key": "^(签到|打卡)\\s*([\\(（].*|\\d+)?$",
        "reply": "/// 记录每位用户是第几个打卡以及累计天数\n[%{daka_today_%uid%}%]*>您已打过卡\n[%living%+1]>签到成功，您是今天第%[%{daka}%+1]%个，本月%[%{daka_month_%uid%}%+1]%天\\n\\\n\t>setValue(daka, %[%{daka}%+1]%)\\n\\\n\t>setValue(uname_%uid%, %uname%)\\n\\\n\t>setValue(daka_today_%uid%, 1)\\n\\\n\t>setValue(daka_sum_%uid%, %[%{daka_sum_%uid%}%+1]%)\\n\\\n\t>setValue(daka_month_%uid%, %[%{daka_month_%uid%}%+1]%)\\n\\\n\t>setValue(daka_keep_%uid%, %[%{daka_keep_%uid%}%+1]%)\\n\\\n\t>setValue(integral_%uid%, %[%{integral_%uid%}%+1000]%)\\n\\\n\t>triggerEvent(DAKA_MONTH_%[%{daka_month_%uid%}%+1]%)"
    },
    {
        "anchor_key": "神奇弹幕:AutoReply",
        "enabled": true,
        "key": "^(查询(打卡|签到)|(打卡|签到)查询)$",
        "reply": "[%living%+1]连续%[%{daka_keep_%uid%}%]%天，本月%[%{daka_month_%uid%}%]%天，累计%[%{daka_sum_%uid%}%]%天"
    },
    {
        "action": "/// 重置每天打卡的人数\n[%living%+1]>setValue(daka, 0)\\n\\ // 重置今日打卡人数\n\t>removeValuesIf(^daka_keep_(\\d+)$, [!_{daka_today__$1_}_])\\n\\ // 未连续签到断开\n\t>removeValues(daka_today_\\d+) // 重置每人是否打卡",
        "anchor_key": "神奇弹幕:EventAction",
        "enabled": true,
        "event": "NEW_DAY_FIRST"
    },
    {
        "action": "/// 重置每月打卡天数\n[%living%+1]>setValues(daka_month_\\d+, 0)",
        "anchor_key": "神奇弹幕:EventAction",
        "enabled": true,
        "event": "NEW_MONTH_FIRST"
    },
    {
        "action": "您已打卡满21天，可找主播领小礼物~",
        "anchor_key": "神奇弹幕:EventAction",
        "enabled": true,
        "event": "DAKA_MONTH_21"
    }
]

%uname% 点歌的用户，%text% 歌曲名字

可用歌名 [%text%=""] 判断歌曲是否有效， ["%uname%"=""] 判断是在点歌姬中手动搜索添加的歌曲还是弹幕点歌的歌曲。

添加事件：ORDER_SONG_NO_MEDAL，动作：

(cd35:600)请戴粉丝牌点歌

加了冷却通道，最多十分钟提醒一次。

在播放随机音乐时，用户点歌则立即播放。若已在播放其他用户点的歌，则无效。

添加点歌成功事件：ORDER_SONG_SUCCEED，动作：

["%playing_song%" != "", "%song_order_uname%" = ""]>cutOrderSong()

其中加粗事件表示程序中默认已用上（允许重复使用），并且能获得详细用户ID、昵称、粉丝勋章等信息。

未加粗事件则只是接收数据，未进行解析。

考虑到发送弹幕的限制，如果同一个事件添加多条弹幕，那么会按队列顺序发送，而不会一口气发完。

并且有冷却（默认2秒左右），可以在开头加上冷却通道例如 (cd78:0)消除冷却

另外，需注意 PREPARE，若开启了“仅直播时回复”，那么大部分动作（包括弹幕、命令等）将不会执行，可在下播结束语中操作

指定某一位用户的弹幕，重复其弹幕

添加事件：DANMU_MSG，动作：

[%uname%=用户昵称]%text%

支持可通过网络访问的任意机器人接口。

以酷推为例：https://cp.xuthus.cc，按其说明配置

添加开播事件：LIVE，动作：

>connectNet(https://push.xuthus.cc/group/[skey]?c=[开播消息])

其中 [skey]为您的酷推Skey，[开播消息]按服务格式自定义

一切配置妥当，开播时将会自动发送消息至QQ群。

下播30秒后电脑自动关机

添加下播事件：PREPARE，动作：

>timerShot(30000, >runCommandLine(shutdown -s -t 30))

添加开播事件：LIVE，动作：

>runCommandLine(shutdown -a)

多了延时30秒和响应开播事件，是排除主播意外掉线的情况。

添加分享事件：SHARE

添加弹幕动作：

感谢%ai_name%分享%upname%的直播间！

其中 %upname%可以使用菜单中的“自定义变量”来统一设置，也可以固定写死。

添加事件：GUARD_BUY，动作：

>playSound(%app_path%/audios/guard.mp3)

有人上船则自动播放 安装目录/audios/guard.mp3，本程序不自带，需要自己找音频文件放上去。也可以是安装目录之外的绝对路径。

需要主播登录，添加事件：FIRST_GUARD，动作：

>postData(https://api.live.bilibili.com/live_user/v1/RoomAdmin/add, admin=%uid%&anchor_id=%room_id%&csrf_token=%csrf%&csrf=%csrf%&visit_id=)

事件中添加事件：NEW_GUARD_COUNT，动作：

恭喜%uname%成为第%number%位船员！

需要在设置中开启“监听勋章升级”，否则不会一直刷新勋章。

送完礼物后勋章升级（仅送礼，不包括上船、每天第一条弹幕）

添加事件 MEDAL_UPGRADE，动作：

[%medal_level%>=5, %anchor_room_id%=%room_id%]恭喜%ai_name%勋章升级至%medal_level%~

注意：用户此时佩戴的粉丝勋章（即 %anchor_room_id%）不一定是当前直播间的，所以要判断一遍。

添加事件：ANCHOR_LOT_AWARD，动作：

恭喜%uname%中奖：%text%

保存弹幕记录到 “mydir/danmu.txt”： 事件：DANMU_MSG 动作：>appendFileLine(mydir/danmu.txt, %uname%: %text%)

保存送礼记录到“mydir/gift.txt”： 事件：SEND_GIFT 动作：>appendFileLine(mydir/gift.txt, %gift_name% %number% %uname%)

大乱斗结束前30秒提醒：一次大乱斗为5分钟，开始后4分半发送弹幕，270秒=270000毫秒。

添加事件：PK_BATTLE_START，动作：

>timerShot(270000, 离大乱斗结束还有30秒)

添加事件：PK_BATTLE_PRE，动作：

>setValue(pk_ceng, 0)

添加事件：SEND_GIFT，动作：

[%pking%, %{pk_ceng}%=0, %gift_gold% >= 100000, %gift_num%=1]>setValue(pk_ceng, 1)\n>sendGift(20004, 1)

添加事件：PK_BATTLE_END，动作：

[%{pk_ceng}%=0]>setValue(pk_ceng, 1)\n>postData(https://api.live.bilibili.com/xlive/lottery-interface/v2/pk/join, id=%pk_id%&roomid=%room_id%&type=pk&csrf_token=%csrf%&csrf=%csrf%&visit_id=)

添加事件：PK_BEST_UNAME，动作：

[%level%>0, %gift_coin% >= 100]感谢本场最佳助攻：%uname%

仅当赢了，并且本次累计送礼有超过100积分（10000金瓜子）才感谢

对面超过100积分（1万金瓜子）而自己还是0积分的时候，送一个吃瓜保尊严 ╮(╯﹏╰）╭。

添加大乱斗即将结束事件：PK_ENDING

此事件的时间为大乱斗结束前3秒左右。

添加动作：

[%pk_my_votes%=0, %pk_match_votes%>100]>sendGift(20004, 1)

20004 为吃瓜的礼物ID，1为数量

每次结束后5秒，自动重新开始大乱斗的匹配。

事件：PK_BATTLE_SETTLE，动作：

>timerShot(5000, >joinBattle(1))

其中 1为普通大乱斗，2为视频大乱斗。

仅支持 obs，使用直播姬的主播无效。

第一次大乱斗需手动点“发送”开启。

对面主播过来串门时，自己也过去发弹幕。

添加事件：INTERACT_WORD，动作：

[%pking%, %uid%=%pk_uid%]>sendRoomMsg(%pk_room_id%, 我也来串门啦~)

添加事件：PK_MATCH_INFO，将在大乱斗开始的时候，获取对面直播间的信息。

可参考 https://api.live.bilibili.com/xlive/web-room/v1/index/getInfoByRoom?room_id=您的房间ID 的结果，其 data 中的值。

例如：

• 主播名称：%.anchor_info.base_info.uname%
• 勋章名称：%.anchor_info.medal_info.medal_name%
• 舰长数量：%.guard_info.count%
• 粉丝数量：%.anchor_info.relation_info.attention%
• 粉丝团：%.anchor_info.medal_info.fansclub%
• 主播等级：%.anchor_info.live_info.level%
• 主播积分：%.anchor_info.live_info.score%
• 房间名称：%.room_info.title%
• 分区名称：%.room_info.area_name%

示例动作：

匹配到：%.anchor_info.base_info.uname%，%.guard_info.count%舰长，%.anchor_info.relation_info.attention%粉丝

v3.7.4 添加此事件

添加事件：PK_END，动作：

[%level%>0]>setValue(winCount, %[%{winCount}%+1]%)\n>triggerEvent(winCountReport)
[%level%<0]>setValue(winCount, 0)

添加事件：winCountReport，动作：

[%{winCount}%>=3]目前连胜场数：%{winCount}%

如果要手动调整连胜数量（例如5），可以添加以下动作，手动点击“发送”，事件可以留空：

>setValue(winCount,5)

每天清零，事件：NEW_DAY_FIRST，动作：

>setValue(pk_win, 0)

V4.2.0 支持连胜事件 PK_WINNING_STREAK 了，%number% 直接获取到连胜数量

添加事件：PK_WINNING_STREAK，添加回复：

[%number% > 5]恭喜达到%number%连胜！

添加事件：PK_MATCH_ONLINE_GUARD，将在大乱斗开始的时候，获取对面直播间在线舰长人数。

%number% 获取总人数，%.guard1% 总督，%.guard2% 提督，%.guard3% 舰长

动作：

[%number%>30]*危！对面有%number%名舰长在线！
[%number%>20, %.guard1%>0]**对面有%[%number%-%.guard1%]%名舰长在线，%.guard1%名总督
[%number%>0]对面有%number%名舰长在线！

这是对面直播间的事件，均需要开启大乱斗消息同步。

需要在设置中开启“接收私信”，每当有未读的消息发过来时触发该事件。可获取以下常用值：

通过命令 >sendPrivateMsg(%uid%, 回复内容) 来发送私信，实现聊天与自动回复。

以下示例实现了当私信包含“hello”时，显示消息到弹幕姬上，并自动回复“你好”：

[%.last_msg.msg_type% != 1]***
[[[%text% ~ hello]]]>localNotify(收到私信：%username%：%text%)\n\
                    >sendPrivateMsg(%uid%, 你好~)

通过智能闲聊的接口来实现私信的机器人智能回复功能。

添加私信事件：RECEIVE_PRIVATE_MSG：

[%.last_msg.msg_type% != 1]***
>aiChat(%text%, >sendPrivateMsg(%uid%, 【自动回复】\%text\%))

当收到私信时，机器人会自动回复。

通过用户发过来的私信，将其中的关键信息保存到本地。

例如用户发送 “设置我的地址：浙江省杭州市xxxx”，神奇弹幕永久保存该数据，用以后续发货表单自动填写。

添加私信事件 RECEIVE_PRIVATE_MSG：

[%.last_msg.msg_type% != 1]***    // 忽略系统通知等无关消息
[[[%text% ~ ^设置我的]]]>triggerReply(%text%)
[[[%text% ~ ^兑换奖品]]]>triggerReply(%text%)
[[[%text% ~ ^我的信息$]]]>sendPrivateMsg(%uid%, 名字：%{info/name_%uid%}%，地址：%{info/addr_%uid%}%，号码：%{info/num_%uid%}%)

添加回复 ^设置我的(.+)[：:](.+) （^ 在正则表达式中为开头的意思）：

[[[%$1% = 名字]]]>setValue(info/name_%uid%, %$2%)\n>sendPrivateMsg(%uid%, 已设置您的名字为：%$2%)
[[[%$1% = 地址]]]>setValue(info/addr_%uid%, %$2%)\n>sendPrivateMsg(%uid%, 已设置您的地址为：%$2%)
[[[%$1% = 号码]]]>setValue(info/num_%uid%, %$2%)\n>sendPrivateMsg(%uid%, 已设置您的号码为：%$2%)

本程序并不直接支持 Excel，所有的相关操作都需要导入/导出为 CSV 文件（本质上就是 txt 文件）。

通过添加一行数据，将用户操作内容、个人信息保存到表格文件中。

例如用户发送 “兑换奖品：红包”，结合上一个示例的设置信息，可能生成以下表格格式（标题需要在使用前手动加上）：

添加回复 ^兑换奖品[：:](.+)$：

[[["%{info/name_%uid%}%" = ""]]]*>sendPrivateMsg(%uid%, "请先发送“设置我的名字：xxx”来设置收件人姓名")
[[["%{info/num_%uid%}%" = ""]]]*>sendPrivateMsg(%uid%, "请先发送“设置我的号码：xxx”来设置手机号码")
[[["%{info/addr_%uid%}%" = ""]]]*>sendPrivateMsg(%uid%, "请先发送“设置我的地址：xxx”来设置收件地址")
[[[%$1% = 手作; %$1% = 红包]]]>appendFileLine(兑奖.csv, \
		%uid%, %uname%, %$1%, %{info/name_%uid%}%, %{info/num_%uid%}%, %{info/addr_%uid%}%, %>time(yyyy-MM-dd hh:mm)%)\n\
	>sendPrivateMsg(%uid%, 操作成功)

生成的 兑奖.csv 文件可直接使用 Excel 打开、修改，或另存为 Excel 表格文件。

如果生成的文件在www文件夹中，则可以通过浏览器访问，非常适合挂在服务器上供他人下载。

Excel 菜单中可导出为 CSV 文件，去除所有格式，只保留数据，每列之间以英文逗号“,”隔开

以奖品发货为例，用户私信自动添加到表格（也可以是上船/礼物/弹幕/中奖等任意事件），主播手动发货后，使用神奇弹幕批量回复“已发货”：

继上述表格文件，任意处添加代码：

>csvEachLine(兑奖.csv, >sendPrivateMsg(\%$1\%, 【发货提醒】您的“\%$3\%”已发货~)%n%>delay(3000))

从表格中读取 UID（第一列使用 %$1% 读取，又因为是在 >csvEachLine 中调用，加上反斜杠 \ 转义）和奖品（第三列），向相应的用户发送私信。

可多加一列快递单号，手动填写，通过私信一并发送。

延时 >delay(3000) 表示发送私信之间间隔 3 秒，瞬间大量发送私信会导致被封禁。

私信的 Json 数据，可通过 %.key1.key2.key3% 这样的形式来获取。另外，通过接口附加上了“sender”字段，可获取发送者的信息（API不稳定，不一定获取到）。具体示例如下（省略了部分不常用数据）：

{
    "talker_id": 324495090, // 用户ID
    "session_type": 1,
    "at_seqno": 0,
    "top_ts": 0,
    "group_name": "",
    "group_cover": "",
    "is_follow": 1,
    "is_dnd": 0,
    "ack_seqno": 193772296863792,
    "ack_ts": 1647245795072485,
    "session_ts": 1647309089148477,
    "unread_count": 6,
    // 最后一条消息。例如获取消息类型：%.last_msg.msg_type%
    "last_msg": {
        "sender_uid": 324495090,
        "receiver_type": 1,
        "receiver_id": 20285041,
        "msg_type": 1,    // 消息类型，1 用户私信
        "content": "{\"content\":\"测试消息\"}",
        "msg_seqno": 194835318046736,
        "timestamp": 1647309089,
        "at_uids": null,
        "msg_key": 7075138663693631915,
        "msg_status": 0,
        "notify_code": ""
    },
    "group_type": 0,
    "can_fold": 0,
    "status": 0,
    "max_seqno": 194835318046736,
    "new_push_msg": 0,
    "setting": 0,
    "is_guardian": 0,
    "is_intercept": 0,
    "is_trust": 0,
    "system_msg_type": 0,
    "live_status": 0,
    "biz_msg_unread_count": 0,
    // 发送者信息（视网络，可能获取不到）
    "sender": {
        "code": 0,
        "message": "0",
        "ttl": 1,
        "data": {
            "mid": 324495090,
            "name": "般若菠萝包rollora",
            "sex": "女",
            "face": "http://i0.hdslb.com/bfs/face/63340c49aa7915426f4ba5019cd27a5cbec098b8.jpg",
            "face_nft": 0,
            "sign": "自由人，生活向主播，经纪人",
            "rank": 10000,
            "level": 5,
            "jointime": 0,
            "moral": 0,
            "silence": 0,
            "coins": 0,
            "fans_badge": true,
            "fans_medal": {
                "show": false,
                "wear": false,
                "medal": null
            },
            "is_followed": true,
            "live_room": {
                "roomStatus": 1,
                "liveStatus": 0,
                "url": "https://live.bilibili.com/11046586?broadcast_type=0&is_room_feed=1",
                "title": "房间标题",
                "cover": "http://i0.hdslb.com/bfs/live/new_room_cover/5987df8547248533f87bcbb40926742d8ce07a17.jpg",
                "roomid": 11046586,
                "roundStatus": 0,
                "broadcast_type": 0,
                "watched_show": {
                    "switch": true,
                    "num": 220,
                    "text_small": "220",
                    "text_large": "220人看过",
                    "icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png",
                    "icon_location": "",
                    "icon_web": "https://i0.hdslb.com/bfs/live/8d9d0f33ef8bf6f308742752d13dd0df731df19c.png"
                }
            },
        }
    }
},

这一类事件专门用于在某些操作之前进行过滤，相当于高度自定义的黑白名单。

当结果的弹幕包含命令 >reject() 时，将不会执行正在过滤的操作。

若有多行，同其他代码一样，随机获取一行；其他弹幕或命令正常发送。

若有多个相同过滤器，只要任意其中一个包括 >reject() 命令，则本操作不允许。

另外，过滤器不支持发送选项（冷却通道、等待通道）；若有需要，放到条件判断中。

注意：默认开启过滤器，可能会在一定程度上造成卡顿，可在弹幕设置中关闭。

只允许舰长或者带本房间粉丝勋章的用户点歌

事件：FILTER_MUSIC_ORDER

["%anchor_room_id%" != "%room_id%", !%guard%]>reject()

两个条件：不是舰长、未戴本房间勋章，当成立时，执行 >reject() ，即阻止点歌，当做无事发生。

只显示舰长进入的消息，其他用户进入都不显示

事件：FILTER_DANMAKU_COME

[!%guard%]>reject()

赠送的小心心、辣条等不会显示在弹幕姬上

事件：FILTER_DANMAKU_GIFT

[%gift_gold% = 0]>reject()

相关函数：filterReject(filter)

在事件中，事件为自定义的过滤器名字，即参数中的 filter。相应动作带有 >reject()则表示拒绝，返回1；若不拒绝，则默认通过，返回0。

除了 >reject()，过滤器中的其余操作都会如普通弹幕命令一样正常执行。

相关函数：inFilterList(filter, content)

返回的弹幕改为词库，多个词语之间用空格或者换行分隔。

只要词库中其中一个词语在 content 中，则返回 1。否则返回 0。

相关函数：inFilterMatch(filter, content)

返回的弹幕改为正则表达式，多个表达式用多行表示。

只要 content 满足其中一个表达式，则返回 1。否则返回 0。

事件中，以 KEY: 开头，则会自动注册全局快捷键，例如 KEY:ctrl+1，则是注册快捷键 ctrl+1，全局皆有效。此时任意地方按下 ctrl+1 就会执行这个事件里面的代码。

注：受限于 B 站弹幕发送必须有间隔（2秒），代码会有延迟，不一定是立即执行

例如送指定礼物做10个蹲起，这时候需要显示蹲起的数量。

添加新连接事件：WEBSOCKET_CMDS，动作：

[%text%=SQUAT]>sendToSockets(SQUAT, {"cmd":"SQUAT", "data":%{squat}%})

添加 初始化蹲起数量的动作（事件建议留空，手动点击发送按钮）：

>setValue(squat, 0)\n>sendToSockets(SQUAT, {"cmd":"SQUAT", "data":0})

添加 蹲起数量+1的动作（事件自选，可空着手动点发送来增加次数）：

>setValue(squat, %[%{squat}%+1]%)\n\
	>sendToSockets(SQUAT, {"cmd":"SQUAT", "data":%[%{squat}%+1]%})

创建 www/squat.html文件，写入：

<head>
    <title>神奇弹幕蹲起</title>
    <script src="js/jquery.js"></script>

    <style type="text/css">
        .card {
            background-color: #fff;
            box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.2);
            transition: 0.3s;
            /* width: 40%; */
            border-radius: 5px;
            padding-left: 20px;
            padding-right: 20px;
        }

        .card:hover {
            box-shadow: 0 8px 16px 0 rgba(0, 0, 0, 0.2);
        }
    </style>
</head>

<body>
    <div class="card" style="display:inline-block">
        <h1 id='count'>蹲起个数：0</h1>
    </div>

    <script type="text/javascript">
        $(document).ready(function () {
            var ws = new WebSocket("ws://__DOMAIN__:__WS_PORT__");
            ws.onopen = function () {
                ws.send('{"cmd":"cmds", "data":["SQUAT"]}');
            };
            ws.onmessage = function (e) {
                var json = JSON.parse(e.data);
                var cmd = json['cmd'];
                switch (cmd) {
                    case 'SQUAT':
                        console.log(json);
                        var count = parseInt(json['data']); // 这就是个数
                        $("#count").html('蹲起个数：' + count);
                        break;
                }
            };
        });
    </script>
</body>

访问 localhost:5520/squat.html（域名端口按照设置的来），显示 蹲起数量：0。

每次点事件中“蹲起数量+1”那一项的“发送”按钮，对应蹲起数量加一。

var ws = new WebSocket("ws://__DOMAIN__:__WS_PORT__");
ws.onopen = function() {
    ws.send('{"cmd":"cmds", "data":["SONG_LIST"]}');
};

>sendToSockets(SOME_CMD, \
	{\
		"action": "SOME_ACTION",\
		"data": {"key1": "value1", "key2": 222}\
	})

<ol id="songs" class="live numbers"> </ol> <!-- 被修改的ul -->

ws.onmessage = function(e) {
    console.log(e.data); // 打印接收的json格式，类型太多，就不一一说明了
    var json = JSON.parse(e.data);
    var cmd = json['cmd'];
    switch (cmd) {
        case 'SONG_LIST':
            var songs = json['data']; // 歌曲对象组成的数组
            var olHtml = '';
            for (var i = 0; i < songs.length; i++) {
                var song = songs[i]; // 歌曲对象，可获取歌名、歌手、用户等
                olHtml += '<li>' + song['name'] + "</li>";
            }
            $("#songs").html(olHtml);
            break;
    }
};

[%.cmd% == ONE_CMD]执行ONE_CMD动作
[%.cmd% == ANOTHER_CMD]执行ANOTHER_CMD动作

{
	"cmd": "CLICKED",
	"data": {
		"name": "小明"
	}
}

{
    "cmd": "GET_CONFIG",
    "data": {
        "key1": 123,
        "key2": "某个值",
        "key3": 10.08,
        "key4": false,
        "key5": null
    }
}

{
	"cmd": "GET_INFO",
	"data": {
		"key1": "key1表达式",
		"key2": "key2表达式"
}

function socketInited() {
    var json = {
        cmd: "GET_INFO",
        data: {
            room_id: "%room_id%",
            title  : "%room_name%",
            pk     : "%pking%"
        }
    }
    appWs.send(JSON.stringify(json));
}

function readInfo(data) {
    roomId = data['room_id']; // 获取到的房间ID
    title  = data['title'];   // 房间标题
    pking  = data['pking'];   // 是否正在PK
}

{
    "cmd": "GET_INFO",
    "data": {
        "room_id": "123456",
        "title": "标题",
        "pk": "0"
    }
}

{
    "cmd": cmd类型,
    "data": 数据
}

{
    "name": "点歌姬",			  // 扩展整体名字
    "min_version": "4.4.0",		// 能用的神奇弹幕最低版本，过低会报警告
    "author": "小乂",			   // 作者名字
	"list": [					// 允许多个网页，list中一项一个
		{
			"name": "弹幕点歌列表",       // 这是显示出来的名字
			"url": "index.html", // 相对于主机地址的URL路径
			"desc": "显示弹幕点歌的实时列表，播放完毕后自动移除", // 简单描述与说明
            "author": "作者名",   // （可空）单独的作者名字
			"css": "list.css",   // （可空）便于用户修改的CSS文件相对于www文件夹的路径
            "css_custom": "list_custom.css", // （可空）用户自定义CSS，修改后会覆盖上面一项
            "cover": "cover.png",		// （可空）扩展封面图片，默认为 cover.png
            "code": [], 	// （可空）有些弹幕交互程序需要添加的代码，代码块菜单“复制+继续复制”后粘贴到此处
            "config": "config.html",	// （可空）扩展的配置页面
            "homepage": "http://xxx",   // （可空）主页链接
            "contact": "http://xxx",    // （可空）联系作者
            "reward": "http://xxx",     // （可空）打赏链接
            "dir": "images",			// （可空）打开某一文件夹，比如图片资源，用于用户替换
            "file": "result.txt",		// （可空）打开某一文件，比如保存的抽奖结果
            "menus": [					// （可空）自定义扩展的右键菜单
                {
                    "name": "自定义菜单",
                    "url": "http://xxx",
                    "code": ""			// 点击这个菜单项要执行的代码/弹幕
                }
            ]
		},
		{
			"name": "当前歌曲名字",
			"url": "/music/playing.html",
			"css": "/music/playing.css",
			"desc": "点歌姬正在播放的歌曲的名字"
		},
        /* ... */
	]
}