火狐画中画字幕需三条件：启用about:config中media.videocontrols.picture-in-picture.display-text-tracks.enabled为true；主页面手动激活字幕轨道；video元素含合法track标签且跨域时加crossorigin="anonymous"。

火狐浏览器画中画视频悬浮窗无法显示字幕，常见于主页面字幕正常但一进入画中画就消失，根本原因在于字幕轨道未被主动继承到悬浮窗口上下文中，必须同时满足底层开关开启、字幕已手动激活、video元素具备合法track声明三个硬性条件。

启用字幕渲染的核心配置

这一步是所有后续操作的前提，缺一不可。若跳过此步，其他操作全部无效。

在地址栏输入 about:config 并回车 → 点击“接受风险并继续” → 在搜索框中输入 media.videocontrols.picture-in-picture.display-text-tracks.enabled → 若该条目不存在，右键空白处 → 新建“布尔值” → 名称严格填写为上述完整字段 → 值设为 true。

注意：display-text-tracks.enabled 是字幕能否在画中画窗口里渲染的硬性开关，不是可选项，而是强制前提。仅设 show-captions 为 true 不足以触发渲染，很多用户卡在这一步却反复检查网站或字幕文件。

确保字幕轨道已被主页面显式激活

画中画不会自动“猜测”你要哪条字幕，它只继承当前处于 active 状态的 track。哪怕网页有10条字幕，没点开那一条，画中画里就是空的。

播放视频 → 找到播放器下方的“CC”按钮或字幕图标 → 点击展开语言列表 → 从中选择一种语言并确认状态变为“已启用”（非“自动”或灰色禁用态）→ 此时再触发画中画。

如果网站字幕按钮点击无反应，说明字幕轨道尚未加载完成或未通过 HTML5 标签声明——此时需进入下一步手动补全。

用开发者工具补全 video 元素的字幕上下文

部分网站（尤其是自建站、教育平台、本地 HTML 页面）使用 JS 动态加载字幕，绕过了 标签，导致画中画环境丢失轨道引用。必须手动注入标准结构。

page-agent 浏览器控制（CDP）

使用 page-agent CLI（CDP）控制浏览器；CLI只能通过 GitHub Release 的 .tgz 安装，npm 官方包暂未发布。

下载

方法一：补 标签

播放视频并开启字幕 → 按 F12 打开开发者工具 → 切换到 Elements 面板 → 展开找到

方法二：加 crossorigin 属性

若已有 但 src 指向跨域资源，必须给

验证并刷新当前页面

完成上述全部配置后，不要仅暂停/重播视频，必须执行完整刷新操作。

按 Ctrl + R（Windows/Linux）或 Cmd + R（Mac）强制刷新当前页面 → 等待视频和字幕完全加载完成 → 再次手动开启字幕 → 最后通过右键菜单或快捷键 Ctrl + Shift + P 触发画中画。

若仍不显示，打开开发者工具的 Console 面板，查看是否有 CORS 错误或 404 报错——这表示 track 的 src 路径无效或未开放跨域权限。