[toc]
简介
神奇弹幕以直播间为平台，利用网络通信技术、音视频技术、智能控制技术将直播有关的功能集成，构建高效的现代化播出环境与观众互动的管理系统，提升直播亲密性、便利性、艺术性，并提供全方位的信息交互功能。通过网络化综合智能控制和管理，实现“以人为本”的全新直播体验。
整合弹幕姬+答谢姬+点歌姬+回复姬+工作流(workflow)，支持弹幕聊天、观众互动、自动点歌、数据统计、私信处理等。最大的特点是可编程控制，自由制定规则，蕴含无限可能！
本程序以打造自动化直播间为主线，以建设高粘性粉丝团体为目标，坚持办好每一场直播、帮助每一名主播，保持观众互动，实现粉丝裂变，打造直播高峰，做有温度的直播助手。与此同时，规范观众行为秩序，促进直播产业健康有序发展，营造清朗的网络环境。
QQ群：1038738410，欢迎交流反馈与研究新功能~
神奇
- 主播秘书，一键上播下播、修改分区，直播数据收集与整理
- 根据约束条件（时间、等级、勋章等），按条件智能欢迎/答谢
- 外语自动翻译、AI闲聊回复、生僻字读音等自动化功能
- 粉丝变化、热门榜、大乱斗、船员变化、新人发言等种种数据
- 大乱斗查看双方串门的粉丝、同步视频PK对面消息、跑骚抓人
- 私信处理、感谢分享、最佳助攻、打卡回复、语音播报等
- 全自动点歌、弹幕切歌、自动暂停其它音乐、排队时长提示
- 点歌姬自动切换网易云/QQ/咪咕/酷狗，支持会员与本地导入
- 完全无人值守，远程控制，开播QQ群播报、自动录播
- 播放各音乐平台会员歌曲，没有版权的歌曲自动更换播放源
- 单个粉丝设置特别关心、强制提醒、专属昵称、永久禁言等
- 查看每名观众进来次数、礼物总计、弹幕记录、判断机器人等
- 弹幕语音播放与回复，百度/讯飞/微软语音等多个接口
- 小窗闲聊、迷你视频、快速截图，上班摸鱼挂后台听直播必备
- 自动签到、参与天选、领取小心心、赠送到期礼物
- 大量可编程运算、网页访问，超高自由度的弹幕机器人
- 游戏设计，比如扣1禁言、关注解禁、送礼物优先点歌等
- 更多神奇的隐藏功能，用户自己开发定制或者导入已有扩展
设置账号Cookie
如果要发送弹幕，必须登录账号。目前有二维码登录和手动设置Cookie两种方式。
方式一：二维码登录
直接点开菜单中的“账号——二维码登录”，使用哔哩哔哩APP扫码确认。
方式二：使用浏览器Cookie登录
- 浏览器上按
F12打开【开发者工具】，Network - XHR
- 进入或刷新B站主页（没登录的需登录），Name多了一排，点其中任意一个（若找不到Cookie就换个）
- 复制如下图的cookie至右上角登录账号的菜单中的“设置Cookie”，即可进行发送。
使用Cookie也是为了保证账号安全，当程序借给别人时，自己可以远程退出Bilibili账号，所有登录失效。之后则需要重新设置cookie。
欢迎弹幕
以下多项功能支持自定义弹幕、大量可编程变量，具体说明请参考下面的“可编程设计”。
普通的欢迎：
%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%，太久没来了哦~大乱斗对面来人：
[%pk_opposite%]***欢迎%ai_name%串门哦~送礼答谢
- 普通的答谢：
谢谢 %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%=吃瓜]**
浏览器插件
开启“扩展—网络服务”，之后于直播姬中添加浏览器并访问网址，即可打开插件页面，无缝嵌入直播界面。
网址为：
http://localhost:5520 + 路径。目前支持以下功能：
说明
路径
/music/index.html
/music/playing.html
/music/lyrics.html
/gift/index.html
/gift/end_thanks.html
例如点歌列表，默认的链接是：
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; }
调试日志
如果经常遇见问题，请按以下方法开启日志：
重启神奇弹幕，根目录下会出现 debug.log，这就是调试日志。
盘查问题时需要将这个文件交给开发者。
工作流的意义
直播间实施工作流管理所带来的好处是非常明显的，这包括提高直播间运营效率、改善人气资源利用、提高直播运作的灵活性和适应性、提高工作效率、集中精力处理弹幕聊天、跟踪观众互动过程、量化粉丝粘度、统计礼物数量，充分发挥现有直播数据的作用。实施工作流将达到缩短互动等待周期、改善弹幕流程、优化并合理利用资源、减少人为差错和延误、提高吸粉效率等目的。
总结可编程工作流带来的好处，可以归纳为以下几点：
要处理的事项自动回复
不需要对观众的数据进行手动整理
主播只需要将精力集中在关心的互动上
保存所有历史记录
随时看到统计数据
达到无纸化办公的目标
完全支持分布式架构，多设备同时工作
科学管理更近一层，直播效率明显提高
直播间的核心竞争力将有所提升
通过流程自动化与数据库集成，以及各类表单统计查询功能，提高决策能力
工作流的实现需要三个基本步骤：映射、建模和管理。映射是第一个步骤，其首要任务是确定直播间内全部现有的手工和自动化的业务流程；建模则是开发一个有助于与观众交互的模型。第三阶段是软件实施以及跨越多项业务逻辑的无缝系统集成。
为了确保工作流系统能够无缝地衔接到直播间中，用户必须遵从已经定义好的、经过实践确认的行之有效的脚本规则，并且在每个脚本都必须有可以度量的结果。在实际使用中，根据主播的情况来制定符合要求的脚本，在易用性和功能需求之间达到平衡。
简单介绍
弹幕的候选列表中，支持一系列的可编程变量、简单逻辑运算、简单算术运算。
使用两个
% 包括的英文，则为变量。数据变量例如 %uname%，与当前的一系列数据相关，例如礼物价值、今日人数等等；招呼变量例如 %greet%，自动替换为当前时间段对应的招呼语，例如候选项表达式 %ai_name%，%greet%%tone/punc%，在早上可能是“早上好啊，某某某”，在下午可能是“某某某，下午好~”，在晚上又会是“晚饭吃了吗，某某某~”。示例：
- 简单的欢迎：
欢迎 %ai_name% 光临~
- 动态语气词：
%ai_name%，%greet%%tone/punc%
看下去，有更多例子。
如无特殊说明，下述代码的符号均以英文符号为准，如
[]、()、,，不支持中文的 【】、（）、， 等。数值修改延迟
所有变量的值都是在触发的一瞬间赋值的，如果在同一行中前面修改了某一值，那么后面的值也不会跟着修改。请看以下示例：
>setValue(count, %[%{count}%+1]%)\n数量：%{count}%
将数量count的大小加1并发送数量的弹幕，但显示的count是修改之前的大小。
应使用以下方式，计算两次：
>setValue(count, %[%{count}%+1]%)\n数量：%[%{count}%+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万时，发送第四项。
批量修改配置
针对
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，所有直播间共享一套数据。解析JSON：网络数据回调
三个联网命令：
getData、postData、postJson，最后一个参数可带有一个“回调入口”。其实这是一个事件，添加该回调同名的事件，即可获取到联网返回的数据。目前只支持JSON格式的返回数据，使用
%.键1.键2.键3% 这样的格式依次获取JSON对象的值，例如：{ "data": { "room": { "roomname": "房间名字" }, "anchor": { "uname": "名字", } } }
其中的roomname获取方式：
%.data.room.roomname%，uname获取方式：%.data.anchor.uname%注意：如果替换出来的内容包含换行，一样会替换到代码中，将会导致弹幕姬出错！
JSON容错处理
如果要允许不存在的键或者超出范围的索引，可以在后面加上英文字符“?”，如：
%.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
示例：禁言小游戏
扣1禁言、关注主播或赠送小心心解除禁言（需要房管或主播）
回复中添加一栏，关键词为
^1$，回复：已自动禁言，赠送小心心或关注主播解禁\n>block(%uid%, 1)\n>addGameUser(%uid%)
这里执行了三个操作：
- 回复
- 禁言
- 添加到游戏用户，等待解除禁言
答谢 — 感谢送礼中添加：
[%in_game_users%,%origin_gift_name%=小心心]***已解除禁言\n>unblock(%uid%)\n>removeGameUser(%uid%)
答谢 — 感谢关注中添加：
[%in_game_users%]*已解除禁言\n>unblock(%uid%)\n>removeGameUser(%uid%)
在两个答谢中，执行了三个操作：
- 回复
- 解除禁言
- 从游戏用户中移除，后续小心心不再触发该游戏，而是普通的答谢
示例：远程开关AI弹幕回复
默认仅机器人和主播可远程控制，而其他人不行。通过此方法设置特定用户（例如舰长、房管）开关。
添加关键词表达式：
^开启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，若是则执行后面的，否则不做操作
示例：打卡计数
发送“签到”或“打卡”进行打卡，并回复第几个以及累计几天；每人每天只能打一次卡。
添加自动回复：
^(签到|打卡)$，动作：[%{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" } ]
示例：QQ群推送开播消息
支持可通过网络访问的任意机器人接口。
以酷推为例：https://cp.xuthus.cc，按其说明配置
添加开播事件：
LIVE，动作：>connectNet(https://push.xuthus.cc/group/[skey]?c=[开播消息])
其中
[skey]为您的酷推Skey，[开播消息]按服务格式自定义一切配置妥当，开播时将会自动发送消息至QQ群。
示例：大乱斗蹭积分卡
添加事件：
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_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%粉丝
示例：大乱斗连胜（旧）
添加事件：
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)
示例：解析私信内容
通过用户发过来的私信，将其中的关键信息保存到本地。
例如用户发送 “设置我的地址：浙江省杭州市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表单
通过添加一行数据，将用户操作内容、个人信息保存到表格文件中。
例如用户发送 “兑换奖品：红包”，结合上一个示例的设置信息，可能生成以下表格格式（标题需要在使用前手动加上）：
添加回复
^兑换奖品[：:](.+)$：[[["%{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 表格文件。示例：批量发送Excel信息
以奖品发货为例，用户私信自动添加到表格（也可以是上船/礼物/弹幕/中奖等任意事件），主播手动发货后，使用神奇弹幕批量回复“已发货”：
继上述表格文件，任意处添加代码：
>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" } }, } } },
示例：远程计数
例如送指定礼物做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”那一项的“发送”按钮，对应蹲起数量加一。
Socket通讯
支持 JavaScript 的 WebSocket 通讯，示例如下：
var ws = new WebSocket("ws://__DOMAIN__:__WS_PORT__"); ws.onopen = function() { ws.send('{"cmd":"cmds", "data":["SONG_LIST"]}'); };
其中，
__DOMAIN__::__WS_PORT__ 会自动替换为用户设置的 域名:端口+1，若未设置，则默认为 localhost:5521。在
onopen方法中，必须向服务端发送格式为{"cmd": "cmds","data":[需要接收的cmd列表]}的 JSON 数据，其中 cmd列表 为接收服务端的哪些命令的字符串数组（相当于白名单），可用事件中的部分命令。另外，有专用的特殊 CMD，如下：
SONG_LIST：点歌列表
LYRIC_LIST：歌词
CURRENT_SONG：正在播放的歌曲
LIVE_ALL_GIFTS：本场直播所有礼物（同一人同一礼物合并），仅接受一次
通过WebSocket，在网页中可接收几乎所有的弹幕消息，显示各种动画特效。
接收主程序消息
以点歌姬的点歌列表为例，接收到
SONG_LIST 并显示在 DOM 节点中：<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; } };
持久化配置
简单使用可选择 localStorage，但不容易跨设备传输与自动备份。
用户在网页程序中自定义配置，永久保存在安装路径下的
ext_settings.ini 中。使用相应的 cmd 实现功能，无需“解锁安全限制”。SET_CONFIG：在网页中发送该 cmd 的 json，将会保存配置。 group 为保存的分组，读取时传入该参数可获取该分组下的所有配置。建议一个应用的配置都保存到同一个分组下。{ "cmd": "SET_CONFIG", "group": "test", "data": { "key1": 123, "key2": "某个值", "key3": 10.08, "key4": false } }
该命令无返回。
GET_CONFIG：返回同样的 cmd，data 中会包含配置的键值对{ "cmd": "GET_CONFIG", "group": "test", "data": ["key1", "key2", "key3", "key4", "key5"] }
可以不添加
data 或留空 "data": []，会返回该 group 下的所有配置。若是 JS 并且使用了默认的
magical_danmaku.js，添加 function readConfig(data)，其中的形参 data 就是返回的 JSON 的 data，可直接读取里面的数值。以上面的
SET_CONFIG 为例，可能会返回 JSON：{ "cmd": "GET_CONFIG", "data": { "key1": 123, "key2": "某个值", "key3": 10.08, "key4": false, "key5": null } }
读取主程序信息
通过ws向主程序发送
GET_INFO 格式的cmd，则会通过内置解释器将一些变量输出为响应的真实数值（都是字符串格式），并按发送的格式返回：{ "cmd": "GET_INFO", "data": { "key1": "key1表达式", "key2": "key2表达式" }
添加
function readInfo(data)，其中形参 data 就是返回的 JSON 中的 data。以获取房间ID、标题为例：
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 需要在扩展中开启
扩展-网络服务-解锁安全限制 方有效（默认关闭）。JSON 格式：
{ "cmd": cmd类型, "data": 数据 }
服务端可接收
cmd类型 如下（不分大小写）：cmdsget_configset_configforward：将 data 中的数据发送给其他 socket，data 中要同样再包含一层 cmd 和 data。完整 JSON 如下：{ "cmd": "forward", "data": { "cmd": "[转发的命令]", "data": "[转发数据]" } }
set_value：修改主程序的原始配置，重启主程序生效。可以有两种形式：// 单独修改一项设置 { "cmd": "set_value", "data": { "key": "[key]", "value": [value] // 可以是字符串，也可以是整数 } }
// V4.7.2新增，同时修改多项设置 { "cmd": "set_value", "data": { "key1": [value1], "key2": [value2], "key3": [value3] } }
send_msg：使主程序发送弹幕，data为弹幕字符串，使用 \\n 来分隔多条弹幕；不会解析变量，而是直接发送出去{ "cmd": "send_msg", "data": "要发送的弹幕1\\n弹幕2\\n弹幕3" }
send_variant_msg：使主程序发送带变量的弹幕或命令，例如 %{key}%；需要用户信息的例如 %uid% 均不可使用。{ "cmd": "send_variant_msg", "data": "数量：%{count}%" }
便携接口
实现了一些简单的接口，便于使用：
用户头像：
/api/header?uid=123456，可直接用于 <img> 标签<img src="http://__DOMAIN__:__PORT__/api/header?uid=123456" />
网络代理：
/api/netProxy?url=网址，可解决本地请求无法跨域问题；其中 网址 若带有参数，则建议进行 URL 编码。请求时使用 GET、POST 等不同方法、设置不同 content-type，都会响应转移到代理中，并自动设置当前登录账号的 Cookies。$.ajax({ url: "http://__DOMAIN__:__PORT__/api/netProxy?url=http://api.live.bilibili.com/xlive/web-room/v1/giftPanel/giftConfig?platform=pc", async: false, dataType: "JSON", success: function (data) { giftList = data["data"]["list"]; } });
该接口除了
url 之外的参数都会设置到请求的 header 中，如：/api/netProxy?url=xxx&referer=xxx&content-type=xxx触发事件：
/api/event?event=事件名&data=url编码(json)，会触发指定事件如 SEND_GIFT。若使用 post 方式，data 部分可直接使用 json 来发送而不需要 url 编码。网页程序打包
所有的网页小程序都是以文件夹的形式放在
www 中，每一套小程序（可以是多个网页）对应 www 中一个文件夹，并带有 package.json 文件（旧版为 info.json），可被神奇弹幕识别，添加到“网络服务”的“已安装扩展”中，并添加一些快捷按钮。以点歌姬为例：
{ "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": "点歌姬正在播放的歌曲的名字" }, /* ... */ ] }
调试模式
以“欢迎”为例，
菜单—调试—调试模式，开启后每次有人进来都会尝试欢迎，有以下几种情况：- 什么提示都没有，甚至看不到人进来：
- 该用户关闭了进入直播间通知
- 短时间反复进入直播间都不会有消息，静等十分钟后再试
- 正常发送欢迎弹幕
- [冷却中]：还在CD，避免刷屏
- [空弹幕，已跳过]：有如下两种可能：
- 按条件跳过（如未戴勋章），即形如
[xxx]****的格式 - 没有符合条件的回复
空弹幕时，可以打开
菜单—调试—最后一次候选弹幕（手速要快，不然会被新弹幕覆盖），查看变量被替换的内容，以及弹幕随机发送的候选项，检查逻辑条件是否有误。如果自己的直播间不行，开启调试中的“本地模式”（不会真正发送弹幕或送礼物），连接到其他人的直播间再进行测试。
一直在获取房间信息？
需要安装VC_redist：https://aka.ms/vs/15/release/vc_redist.x64.exe 后重启神奇弹幕。
大部分Windows自带，但是不排除一些精简版系统将它去掉了。
点歌没有反应
点歌成功但是播放不了，需要安装解码器（如 LAV），然后重启神奇弹幕。
点歌没有加到歌单，请看下面逐一排查：
- 检查点歌设置页面的左上角总开关是否开启
- 要保持播放器页面一直打开（“召唤点歌姬”）
- 检查点歌表达式是否正确，默认格式：点歌 歌名，无需修改
- 如果格式正确，则点歌姬会自动出现搜索歌曲的列表
- 查看点歌设置页面底部有没有点歌列表（最下面方块，点右上角的按钮）
- 如果没有这个列表，则表示点歌的格式不对
- 检查点歌条件，比如勋章限制、连续点歌
- 检查事件中的代码，点歌过滤器中设置了拒绝点歌
- 查看音乐播放器页面的点歌列表有没有未播放歌曲
- 手动暂停的话，点歌后依旧保持暂停状态，是不会继续播放的哦
- 检查是否加入了点歌黑名单（点歌设置页面的右上角）
