跳到主要内容
MisMiss
MIST 标准 · 猫耳FM 参考实现

一个面板,
一群账户,各自精彩

MisMiss 把多个直播账户收进一个 Web 控制台:每个账户拥有独立的 Bot、直播间、插件副本、配置与权限, 用事件驱动的方式处理开播、弹幕、礼物、关注、定时消息和插件生态。

AGPL-3.0Python 3.13+ / Node 20+v1.6.0

把多账户场控,做成一套系统

不是把单账户脚本复制 N 份,而是从数据目录、事件总线到插件权限都为每个账户划清边界。

多账户,真隔离

一个面板托管 N 个账户。每个账户独立目录、独立事件总线、独立插件实例,配置与数据互不串门。

插件库 + 副本

从官方库安装即拷贝一份源码副本到账户目录,之后各账户独立运行、独立更新,互不影响。

声明式插件 UI

插件放一份 _ui_schema.json,就能获得表格、列表、卡片、表单等页面,无需写前端代码。

事件驱动 + 优先级

基于 MRO 的事件分发,监听器按 priority 排序;开播、弹幕、礼物、关注、提问都能精确路由。

三层权限模型

BotPermission 是天花板,插件权限取交集,执行时通过 contextvars 实时校验敏感操作。

定时消息

插件消息、全局消息、房间消息合并轮转,共用一个位置指针;支持仅开播时发送与热更新。

实时日志

loguru 落盘 + WebSocket 批量推送,环形缓冲、断线补发、按账户与级别过滤,万条日志不卡顿。

对平台友好

出站请求分车道限流、在途并发上限、指数退避与抖动,避免把直播间刷进平台风控。

部署与在线更新

Docker 部署包、面板内检查更新、下载校验、备份重建与一键回滚,升级不用手敲命令。

接口层、核心层、控制台,各自只做一件事

所有账户共享同一份插件库;安装时拷贝源码副本,运行时每个账户使用自己的 Bot、直播间、事件总线与插件实例。

  • 接口层只定义契约,换平台不用改业务代码
  • 核心层负责猫耳适配:事件、直播、Bot、插件与出站节流
  • 控制台只做编排与展示,不把平台细节漏进页面
interfacesMIST 抽象接口层
01 · 契约
实体事件BotLivestreamPlugin
↓
core猫耳FM 平台实现
02 · 适配
EventBusPluginManagerThrottleWebSocket
↓
webFastAPI + React 面板
03 · 控制台
REST API多角色认证日志流在线更新
data/accounts/{id}/× N

MissevanBot

Cookie / 权限 / 队列 / 定时器

MissevanLivestream

1 个直播间 + 事件路由

PluginManager

插件副本 / 配置 / 权限 / 数据

EventBus + Router

事件与文本指令两条分发路径

每个账户独立目录:状态、插件源码副本、配置、权限与插件数据。

装好就能用,也可以自己写

官方插件覆盖欢迎、答谢、点歌、互动游戏和房管查询。插件可以使用事件、指令、配置、 权限、定时消息和声明式 Web UI,和内置功能享有同一套能力。

浏览官方插件库

直播间信息

新

房管查询分区、热度与时长

签到

每日打卡与累计统计

骰子

随机骰子与趣味互动

关注感谢

新关注自动致谢

礼物感谢

礼物、盲盒与连击答谢

关键词回复

规则匹配自动回复

艾特回复

被 @ 时自动回应

昵称

称呼与昵称管理

数字炸弹

数字炸弹小游戏

求签

抽签与运势互动

提问感谢

提问自动答谢

歌单

输出配置好的歌单

点歌

弹幕点歌与队列

定时消息

插件侧定时轮播

欢迎

进场欢迎与引导

星座

星座运势互动

插件库共 16 个官方插件;「直播间信息」为 v1.6.0 新增。账户安装时会拷贝独立副本, 库更新不会影响已安装账户,需在账户内点「更新」。

几分钟,把面板跑起来

Windows 开发模式需要 Python 3.13+ 与 Node 20+;服务器推荐使用 Docker 部署包。

Windows / 源码

开发模式
powershell
git clone https://github.com/Dresteam/MisMiss
cd MisMiss
start.bat build

构建完成后打开http://localhost:18080。 默认管理员 MisMiss / MisMiss, 首次登录强制改密。

Docker / 服务器

推荐
bash
# 从 Releases 下载 Docker 部署包
unzip mismiss-1.6.0-docker.zip
bash deploy.sh

部署包内包含镜像、compose、nginx 与 deploy.sh。 也可以在面板「程序更新」页直接检查并安装新版本。

多账户隔离 插件副本 到期停用查看部署文档 →

git clone / docker compose up

把 MisMiss 跑起来

项目以 AGPL-3.0 开源。代码、部署包、更新日志和插件库都在 GitHub, 问题和建议可以直接提 Issue。

github.com/Dresteam/MisMiss · v1.6.0 · AGPL-3.0