更新记录

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

• 第一版发布