更新日志

答谢黑名单与盲盒数量变量

• 进房欢迎、感谢关注、感谢分享三个模块各配一份昵称黑名单，命中的观众不再触发对应的答谢弹幕；留空即不启用，三个模块互不影响
• 黑名单支持通配符：填完整昵称是完全匹配，bill* 匹配以 bill 开头的昵称，*2222 匹配以 2222 结尾的，*A* 匹配包含 A 的
• 比对的是原始昵称、区分大小写，不受「用户名最大长度」裁剪设置的影响，配置页黑名单上方有同样的规则说明
• 自动回复新增 8 个盲盒数量变量，覆盖用户与直播间的本日、本周、本月、总计，按礼物份数统计，与原有的盈利变量一一对应
• 管理后台与商城支持请求体加密，默认不启用：沿用发布包不受影响，只有自行构建前端并配置了签名密钥、且在 HTTPS 或 localhost 下访问时才会生效
• 后台公钥接口统一为 /api/public-key，商城旧接口保留，已经装到桌面的老页面不受影响；这一版没有新增表与列，配置文件也没有新增项，直接升级即可

数据备份与更换数据库

• 新增 db export 与 db import 子命令，停掉程序后一条命令就能把整个数据库备份成 SQL 文件
• 导出的是标准 SQL，带建表语句与索引，不装本程序也能交给 sqlite3、mysql、psql 自带的客户端恢复
• 换数据库也走这套：用旧配置导出、改 config.yaml 的 database 段、再用新配置导入即可，SQLite 与 MySQL / PostgreSQL 之间可以互转
• 导入只认空库，目标库已有数据会直接拒绝并列出哪几张表有数据，不会误覆盖
• 备份与换库的完整步骤，见文档里的数据备份与迁移、切换数据库两章

商城更新机制修复

• 修复积分商城添加到手机桌面后，发布了新版本却一直停留在旧版的问题
• 用户不需要做任何操作：长驻会话每小时自动检查一次更新，从后台切回前台时也会检查
• 已经卡在旧版本的用户，下次打开商城会自动更新过去；如果发现还是旧版，把应用或标签页完全关掉再重开一次即可

从旧版迁移数据

• 欢迎页新增从旧版迁移数据入口，旧版导出的 .gz 文件上传即导入，弹幕、礼物、用户与资产流水一次性搬过来
• 只允许空库导入，三张表任意一张有数据就整体拒绝，这个功能是给新装一套、把旧站搬过来准备的
• 整次导入跑在一个事务里，中途报错或进程被杀都会回滚，可以直接重导
• 积分与星光不直接写库，而是逐条走资产变更并生成流水，导入后余额与流水账对得上
• 导入进来的用户没有密码，沿用商城原有的首次登录设置密码流程

大航海身份与商品限购

• 大航海身份做成可校对的事实：舰长、提督、总督各存一个到期时间，身份由到期时间实时推导，过期即回落普通用户
• 每天 00:01 按直播间大航海名单自动核对一次；名单抓不完整就整体放弃，宁可不动库也不把用户误判成已经下船
• 后台用户列表可以手动变更身份，商城个人中心会显示对应标签
• 商品支持按大航海等级限购，在下单扣款那一步校验，被拦下时订单不产生、余额与库存都不动
• 商城登录页的用户协议接成后台可配置，正文支持 Markdown

数据导出

• 后台 8 个列表页支持导出当前筛选条件下的全部数据，与分页无关
• 覆盖弹幕信息、礼物信息、盲盒信息、用户分析、PK 对战，以及商城用户管理、订单列表、发货管理
• 导出为 CSV，Excel 双击即可打开，表头中文、金额单位为元、时间为可读日期，文件名带模块名与时间戳
• 点击后先统计命中行数，百万行级别约需数秒；单次上限 500 万行，超出会提示缩小筛选范围
• 这一版数据库结构与配置文件都没有变化，直接升级即可

后台首页改版与投诉管理

• 补上投诉管理的后台侧：观众在商城提交的投诉，后台可以按 UID 精确查、按昵称模糊查，并支持排序
• 后台首页改成欢迎页：按时段变化的问候语、上手步骤与常用入口，点卡片直接跳过去
• 房间配置拆成独立页面，机器人登录管理、直播间管理与实时弹幕列表都挪了过去
• 填写不对时会指出具体是哪个参数不对，不再统一报操作失败请稍后重试
• 修复从 v2.0.0 之前的版本升级会卡在数据库迁移、进程直接退出的问题
• 修复 SQLite 环境下搜索词含下划线、百分号或反斜杠时模糊搜索一条都搜不到的问题

积分商城上线

• 新增面向观众的积分商城，观众打开 /shop 即可访问，也能添加到手机桌面当 App 用
• 完整购物流程：商品列表、详情、SKU 规格选择、下单、确认订单、订单列表，下单即锁库存、超时自动归还
• 新增商品管理、订单管理、商城用户管理、App 配置四块后台能力
• 商城与后端之间的请求走 RSA 与 HMAC 加密链路；商城的名称、主题色、图标由后台下发，改完不需要重新打包前端
• 直播侧新增 PK 对战记录：自动解析 PK 结束与结算消息，后台可以回看每场战绩，机器人播报时也能念出与对手的历史交手

弹幕分段与答谢修复

• 超长弹幕会自动拆成几段连着发，中间不会被其他消息插队，同一批分段也只查一次发送权限
• 修复盲盒盈亏统计把金额按分输出、而不是按元的问题
• 修复答谢回复把同名礼物拆开重复念的问题，连刷几个同样的礼物现在会合并成一条
• 积分变动为 0 时不再记录空流水

首个正式版本

• 新增用户分析：按 UID 或昵称检索，日历视图查看每日弹幕数与礼物金额，弹幕词云基于中文分词统计高频词与重复短句
• 新增礼物列表与盲盒礼物查询页面，支持按房间、用户、礼物名称等条件筛选，并给出聚合统计
• 累计弹幕数与累计礼物金额改为数据库原子自增，存量用户由迁移自动补齐，统计失败不再阻断消息入库
• 统一了散落在各处的用户注册逻辑，uid 加唯一索引，避免并发处理时产生重复用户
• 修复分词词典加载失败、以及进入用户分析页后跳转其他页面白屏等问题

弹幕查询与版本检查

• 新增弹幕信息页面，支持按房间、用户、弹幕内容、发送时间筛选，并展示用户勋章信息
• 服务启动时自动比对远程版本号，在控制台提示是否有新版本
• 修复首页登录与监听状态异常分支响应式丢失的问题
• 修复配置项为空字符串时非字符串类型字段解析失败的问题

消费奖励与匹配策略

• 自动回复新增关键词匹配策略与安全词匹配策略，可配置为任意命中或全部命中，老配置自动回退为任意命中
• 新增消费奖励发放：用户消费礼物电池或开通航海时自动发放积分或星光，可按电池数量或航海类型配置
• 弹幕、礼物、互动与 PK 播报中的用户名支持按最大长度裁剪，并可选择省略前面还是后面
• 修复积分与星光日志按 uid 查询和更新用户的问题，改用主键

首个测试版

• 自动互动：弹幕签到、关键词自动回复、礼物答谢、进房欢迎、感谢关注与分享、PK 播报
• 定时广告：设置内容与间隔自动轮播，支持多条随机发送
• 管理能力：黑名单与自动禁言，支持礼物赎回解禁、到期自动解禁；积分与星光变动全程记录
• 网页后台可视化配置，扫码登录，首次运行自动生成配置，不需要手动初始化
• 数据全部存储在本地，不上传任何服务器；Windows、macOS、Linux 均有安装包