更新记录

0.4.6

发布日期：2026-06-12

新增

• 播放统计 Emby 实时会话 新增展示规则，支持按客户端、设备或客户端+设备配置排除规则，并支持精确匹配和包含匹配
• 实时会话支持筛选，支持按客户端或设备快速筛选当前可见会话
• 用户管理新增 用户备注 字段，支持列表展示、备注搜索、单用户编辑，以及批量覆盖或清空备注
• 用户管理新增表格字段显示偏好，可选择列表显示字段

0.4.5

发布日期：2026-05-14

修复

• 修复不显示 Emby媒体、工单开关

0.4.4

发布日期：2026-05-11

新增

• 后台新增 Emby媒体， 支持自动更换封面配置
• 工单 配置新增系统总开关

0.4.3

发布日期：2026-05-08

新增

• 新增独立 工单系统，支持用户中心提交工单、查看详情、补充内容和主动关闭
• 后台新增 工单管理，支持按状态、类型和关键词筛选，管理员可查看详情、回复和关闭工单
• 配置中心新增 工单 配置页，支持维护工单类型、启用状态、排序和 Telegram 接收管理员
• 管理员通知新增 工单通知 开关和个人接收偏好
• 通知模板新增 管理员新工单通知 和 工单用户补充通知

调整

• 后台 工作台 新增 工单概要，展示等待管理员、等待用户和已关闭工单数量
• 后台 工作台 新增 媒体库概览，展示电影数、剧集数、单集数和媒体总数
• 优化公告布局样式
• 用户管理筛选支持筛选 绑定 Telegram 用户

0.4.2

发布日期：2026-04-23

新增

• 用户管理新增排序能力，支持按用户名、创建时间、到期时间、最近播放时间和更新时间排序
• 用户管理 用户标记 筛选新增 只看有播放记录，可快速筛出已有播放记录的用户
• 卡密管理新增排序能力，支持按创建日期、批次和过期日期排序
• 后台 运行日志 页面新增关键词高亮
• 后台 积分中心 Top 10 积分获得 / 消耗用户支持点击跳转到对应用户积分详情

调整

• 优化后台 工作台，新增用户增长、今日活跃、今日签到、白名单用户、在线人数、正在观看和求片处理概览，并继续保留 Emby 探针与定时任务状态
• 后台 积分中心 统计概览新增近 15 天签到人数、积分余额分布、Top 10 积分获得 / 消耗用户、保号扣减趋势，以及近 15 天积分收入 / 消耗趋势图表
• 部分界面体验优化

0.4.1

发布日期：2026-04-22

新增

• 安装页新增 站点地址，可在首次安装时指定 Emby Webhook 等外部回调使用的访问地址
• 后台 配置中心 -> 基础 新增 站点地址 配置，Emby Webhook 地址优先使用该配置
• 用户管理批量修改支持 当前勾选用户，可对已勾选用户执行续费、禁用、启用、重置密码等操作
• 用户管理批量修改新增 设置永久用户 和 取消永久用户

调整

• 首次安装日志和安装表单统一使用 一次性安装 Key，并明确只填写 Key 后面的值
• 同步 Emby 用户时，新用户会员状态默认为 未设置，不再直接显示为已过期
• 用户列表、用户详情、筛选和批量筛选补充 未设置 状态展示
• 优化用户中心每日签到交互：未开启签到验证码时直接签到，开启验证码时保留验证码确认弹窗

修复

• 修复一些已知问题

0.4.0

发布日期：2026-04-21

新增

• 新增 积分系统，支持后台配置积分名称、每日签到随机积分范围，并记录完整积分流水
• 新增用户中心 每日签到 卡片，支持查看近 60 天签到日历；配置 Cloudflare Turnstile 后，签到前需先完成验证码校验
• 新增后台 积分中心，支持查看积分统计概览、积分流水、积分排行，并可按用户、来源、变动类型、操作者和日期筛选
• 新增后台 用户积分详情 页面，支持查看当前积分、最近签到、30/60 天积分变化趋势、完整积分流水，并提供管理员赠送 / 扣减积分入口
• 用户管理新增 积分详情 入口，用户详情抽屉新增积分信息卡片，可直接跳转到该用户的积分详情页
• 新增 积分保号 规则，可与观看保号共存；用户到期自动处理时可按配置扣减积分并复用现有自动续费天数
• 新增 保号续费成功通知，系统保号自动续费成功后可向用户发送续费天数和新到期时间通知
• 新增用户端 自定义主题，支持在配置中心独立配置主题色、登录注册页 / 用户中心浅色与深色背景、背景图片上传预览和用户中心卡片透明度

调整

• 系统设置改版为 基础 配置页，并将账号策略、卡密规则、流量防护等配置按折叠分组展示，降低配置项密度
• 新增 配置中心 单入口布局，左侧切换基础、主题、通知、求片、Emby、Telegram 等配置页，减少侧边栏配置菜单数量
• 优化用户端移动端页面的表单与内容区间距，提升小屏浏览体验

0.3.9

发布日期：2026-04-09

新增

• 新增 观看保号 能力，支持按 最近观看窗口 判断用户是否满足保号条件，并将 会员规则 与 观看规则 统一纳入状态重算
• 新增每日 观看保号扫描 与基于 Emby Webhook 的补偿校验/续期链路，减少仅依赖单一路径导致的漏判
• 异步任务页新增 手动触发 入口，可手动执行 系统到期禁用用户、系统观看保号扫描、系统到期删除用户

调整

• 未登录场景的系统配置接口按最小暴露原则拆分为匿名公共配置与登录后完整配置；
• 用户中心 最近设备 / IP 展示，按 设备 / IP / 时间 显示

修复

• 修复 Telegram Mini App 用户中心页内切换时频繁重新加载和重复请求的问题

0.3.8

发布日期：2026-04-03

修复

• 修复 Telegram 命令同步在 Polling 模式下遇到 429 Too Many Requests 后仍被高频重试的问题；现在会按 retry_after 退避并在后台自动重试，避免持续刷错日志
• 修复 Telegram 自定义指令 在后台删除后仅停留在前端临时状态、刷新页面后又重新出现的问题

0.3.7

发布日期：2026-04-02

新增

• 开放注册支持可组合约束，可同时启用 时间窗口 与 名额限制
• 公共配置接口与 Telegram Mini App 会话接口新增更细的注册状态字段，支持区分 未开始 / 已结束 / 名额已满
• 用户管理详情页新增 解绑 Telegram Bot 操作，管理员可强制解除用户 Telegram 绑定
• 管理员强制解绑 Telegram 后，会立即失效该用户当前用户中心登录态，并记录 user_telegram_unbind 操作日志

调整

• 同时开启公开注册与邀请码注册时，邀请码改为选填；仅在当前普通注册不可用时才强制填写邀请码
• 普通注册关闭但仍允许邀请码注册时，前端会根据关闭原因显示更具体的提示文案
• 网页端求片图片代理改为返回站内相对路径

修复

• 注册验证码区域在组件未完成渲染前增加 加载中 占位，避免空白区域
• Turnstile 验证码首次加载失败时会自动重试一次，仍失败时支持在当前页面直接重新加载
• 优化小屏设备下的验证码区域展示，减少 iframe 宽度导致的溢出问题

0.3.6

发布日期：2026-03-31

新增

• 用户中心新增 播放趋势

修复

• 修复卡密已过期但后台仍显示“可用”的问题

0.3.5

发布日期：2026-03-27

新增

• Telegram 设置新增 自定义指令 配置，支持独立保存、变量预览、MarkdownV2 回复和按 用户 / 管理员 / 群聊 多范围生效
• 卡密管理新增 TXT 导出能力，支持按当前筛选条件导出全部命中的卡密，文件内容为每行一个卡密
• 异步任务页新增任务详情与失败子任务明细查看能力，可直接查看失败原因、重试次数、执行时间和目标用户
• 用户管理批量修改新增 批量重置密码 动作，按异步任务方式为命中用户生成随机新密码并同步到 Emby 与本地账号

0.3.4

发布日期：2026-03-26

新增

• 恢复秘钥与 忘记密码 功能，支持用户通过 用户名 + 恢复秘钥 自助重置密码
• 用户设置页与 Telegram Mini App 设置页新增恢复秘钥生成入口，恢复秘钥只明文展示一次
• 用户中心新增“未生成恢复秘钥”提醒弹窗
• 注册链路新增 Cloudflare Turnstile 验证码，覆盖网页注册和 Telegram Mini App 直接注册
• 流量防护新增忘记密码接口限流，支持按 IP 和 用户名 分别限制
• 管理员下拉菜单新增 系统更新 入口，并在发现新版本时显示全局提醒

调整

• 系统设置页的 开启注册验证码 与 开放用户注册 展开项改为带层级的配置区，便于区分子配置归属
• 版本更新检查从 系统配置 页迁移为独立的 系统更新 页面
• 后台侧边栏重新分组为 工作台 / 用户 / 媒体 / 运营 / 配置 / 运维，将系统参数与运维能力分开显示
• 网页端求片图片改为通过系统签名代理加载

修复

0.3.3

发布日期：2026-03-24

新增

• 公告管理新增 Telegram Bot 私信通知 类型，可向当前所有已绑定 Telegram 的用户一次性发送私信通知
• 播放统计新增 IP 反查 标签页，支持按 IP 和时间范围反查命中过该 IP 的用户
• 用户详情抽屉新增概览摘要，聚合账号信息、会员信息、最近登录、Telegram、设备概况、最近兑换、最近续期和求片摘要
• Telegram 用户指令新增 /myinfo，可直接查看当前绑定账号的基础信息，展示字段与管理员 /user 一致
• Telegram 用户指令新增 /userlf <TMDB链接>，可直接使用 TMDB 电影或剧集链接快捷求片
• 用户页 服务器线路 卡片新增 快捷导入，支持 Forward、SenPlayer、VidHub、Hills

调整

• 公告管理页类型筛选和弹窗选择项改为中文展示
• 播放统计页按标签拆分为独立模块，页面路由状态和共享逻辑集中管理，后续维护更清晰
• 播放统计页移动端布局优化，标签页改为横向滚动，实时会话和用户总览卡片更适配小屏展示
• 播放统计页客户端占比和设备分布占比卡片增加固定内容区高度，数据过多时在卡片内滚动

修复

• 修复播放趋势测试受进程时区影响可能偶发失败的问题
• 修复部分管理端路径在登录态失效后未正确跳转到管理端登录页的问题
• Telegram 管理员拒绝求片原因和续费天数输入改为单次消费，重复消息不再重复执行拒绝或续期；陈旧中的输入会话会自动恢复或过期
• 优化 MoviePilot 推送机制

0.3.2

发布日期：2026-03-21

新增

• Telegram Mini App 入口，支持已绑定账号自动登录、已有账号登录并绑定、Mini App 内直接注册
• 用户中心本地认证层，Emby 不可用时，已激活本地密码的用户仍可登录用户中心
• 用户中心与 Telegram 统一身份体系，网页、TG 绑定、Mini App 和 TG 注册都归到同一套本地用户账号
• 管理员 Telegram 指令升级，新增 /help、/user、/auser、/lf、/renew、/suser、/cancel
• 运行日志系统，关键运行事件同时写入控制台和 data/logs/runtime-YYYY-MM-DD.log
• 后台运行日志页面，支持实时查看当前运行日志
• 通知链路升级为管理员通知和用户通知分离处理，避免大批量用户通知挤占管理员通知
• 管理员通知支持个人接收偏好，管理员可在个人设置中选择接收的通知类型
• Telegram 管理员面板支持按 TG ID 或 Emby 账号查找用户
• Telegram 管理面板支持启用、禁用、白名单切换、设备与 IP 查看
• Telegram 续费支持正负天数调整，可直接回退或延长到期时间
• 求片列表支持在 Telegram 中分页查看、打开详情和直接处理
• 日志页面支持自动滚动、暂停、复制全部和实时刷新

调整

• 用户中心登录改为“本地优先，Emby 兜底激活”
• 用户修改密码时，同步更新本地登录密码和 Emby 密码
• 用户过期、手动禁用、客户端黑名单禁用后，默认仍可进入自助入口，用于续费、改密和查看信息

升级补充

如果当前版本为 0.3.1 或更早版本，升级到 0.3.2 后需要执行以下迁移命令：

docker exec -it bubble-emby-admin /app/bubble-emby-admin migrate v0.3.1-user-auth

0.3.1

发布日期：2026-03-14

新增

• 客户端黑名单策略
• 管理员标记显示
• 管理员豁免客户端黑名单规则
• 工作台新增求片待处理统计

调整

• 单用户启用 / 禁用改为同步执行
• Emby 用户镜像增加管理员字段同步
• 升级前端基础组件库

修复

• 修复用户列表和求片管理表格内容无法直接复制的问题

0.3.0

发布日期：2026-03-13

新增

• 求片系统，支持电影、整剧、单季求片
• 后台求片管理和求片设置页面
• MoviePilot 推送和可选的自动推送 MP
• 用户求片次数限制，支持按天 / 周 / 月配置
• Emby Webhook 入库通知，可自动完成求片工单

调整

• 用户中心改为多页面结构，保留原有导航样式
• 卡密续费与兑换记录合并为同一页面
• 自动闭环升级为“定时扫描 + Emby Webhook”双兜底

修复

• 修复电影 library.new webhook 在 Emby 索引延迟时无法自动完成工单的问题

0.2.4

发布日期：2026-03-12

新增

• 用户管理增加调整到期功能

修复

• Emby 设置保存时会校验地址和 Key 是否可用
• 修复基础用户权限模板弹窗内容左右边框被挡住的问题
• 修复用户列表表格在手机端挤压显示的问题

0.2.3

发布日期：2026-03-11

新增

• 版本更新检查
• 线路管理页，支持增删改查和排序
• 线路支持显示开关和白名单可见
• 用户页增加服务器线路卡片，支持复制线路
• 用户页增加上次活动、最近 30 天观看时长、设备和 IP 信息

修复

• 修复 Bugs

0.2.0

发布日期：2026-03-11

新增

• 播放统计 数据来自 Emby Playback Reporting 插件
• Emby /Sessions 实时会话标签页
• 全站播放时长排行、用户 IP / 设备数量排行、全站设备使用排行
• 客户端占比、设备分布占比、热门影片 / 热门剧集排行
• 多 IP / 多设备 / 高频切换基础风控排行
• 用户画像页
• 用户管理到播放画像的跳转链路
• 用户权限配置
• 用户权限模版以及批量同步
• 从本地恢复用户到 Emby
• Emby 简易探针

修复

• 修复 Bug

0.1.0

发布日期：2026-03-06

• 第一版发布