原作者: 秦始皇
插件原贴: 原贴
以下为二开插件内容

效果展示:

展示不了 官方没安装我的插件 所以还是去我网站看展示吧 点我直达

在原作者的基础下增加了以下内容:
后台可以添加解析接口
添加仅登录账号可播放视频开关,开启以后只有登录了账号才能观看视频,未登录账号点击播放按钮会提示登录

以下为AI生成的内容 (左胳膊受伤,右手一只手懒得写内容了)

B站视频嵌入 (bilibili-player)

rhex 论坛服务端插件 · 当前版本 1.1
自动把帖子正文里的 B站视频链接解析成内嵌播放器。

功能特性

• 自动解析嵌入：扫描帖子正文 HTML,把 B站视频链接(bilibili.com/video/BVxxx、b23.tv/xxx
  短链,支持 <a> 标签和纯文本)替换成封面 + 播放按钮的卡片。
• 点击懒加载：默认只渲染封面,点击播放按钮才创建 <video>
  加载真实视频地址,不影响页面首屏性能。
• 第三方解析接口可配置:默认 api.mir6.com,支持 {url} / {rawUrl} 占位符,或自动追加
  url=&type=json 参数。
• 解析结果缓存:内存 LRU,30 分钟 TTL,最多 100 条,避免重复请求解析接口。
• 仅登录可播放(requireLogin):开启后未登录用户点播放会弹登录提示弹窗,引导去
  /login;已登录用户正常播放。
• 单帖嵌入数量限制:可配置 1–10,默认 3。
• 后台设置页:启用开关、仅登录开关、嵌入数量、解析接口地址,均即时生效。
• 响应式 UI:深色播放器外观,移动端适配,弹窗支持 Esc 关闭。

插件结构

技术要点

1. 接入机制

• 通过 api.registerAsyncWaterfallHook 注册 post.content.render
  hook,串行改写帖子正文渲染后的 HTML。
• 后台能力:registerAdminPage(设置页)+ registerAdminApi(GET/POST 读写配置)。
• 配置走 context.readConfig / writeConfig,key 为 bilibili-embed-settings。

2. 登录鉴权的关键设计(踩坑后的正确做法)

• post.content.render 产出的是所有用户共享、可缓存的
  HTML,服务端无法可靠地把"是否登录"烤进
  HTML——一个登录用户触发渲染后,未登录用户会复用到同一份缓存,导致鉴权失效。
• 因此登录判断必须在 客户端点击播放那一刻实时进行:
  • 服务端只在 HTML 上标记 data-require-login,不烤登录态。
  • 客户端请求 GET /api/auth/me 实时判断登录。
• 响应结构坑:/api/auth/me 未登录时返回

  json
  { "code": 0, "data": { "user": null, "surface": null, "features": {} } }
  data 恒为真值对象,真正的登录标志是 data.user 非空,不能用 data 本身判断真假。
  

• 备选信号:宿主在浏览器暴露 window._rhex.session(isAuthenticated / user,未登录 user 为
  null)。

3. 客户端播放器脚本

• 内联 ,用全局 ready
  标记(__rhexBilibiliPlayerReadyVxxx)防重复初始化,每版递增以使旧脚本失效。
• 播放触发器统一用 (不用 ,避免 JS 失效时误跳转)。
• 事件委托捕获点击,requireLogin 视频先异步查登录态再决定播放或弹窗;会话结果用 promise
  缓存,网络失败不缓存以便重试。

已知限制

• 解析依赖第三方接口,接口失效或限流会导致部分视频无法嵌入(此时保留原链接)。

截图: