双击事件必须绑定在 iframe 的父容器上，不能直接绑定到 iframe 元素本身；因浏览器（尤其 chrome/safari）会忽略对替换元素的 dblclick 监听，需确保父容器有明确尺寸、可见性、非 static 定位，且双击回调中同步调用 container.requestfullscreen() 并添加 allowfullscreen 属性。
双击事件必须绑定在 iframe 容器上，不能只绑 iframe 元素本身
直接给 <iframe></iframe> 绑定 dblclick 事件基本无效——浏览器会忽略对替换元素（如 iframe、img）的双击事件监听，尤其在 Chrome 和 Safari 中。真实生效的是其**父容器**（比如一个 <div class="lay-dbclick-box">），且该容器需有明确尺寸和可见性。<ul>
<li>确保容器设置了 <code>position: relative 或其他非 static 定位，否则内部绝对定位的遮罩层（如 .lay-dbclick-screen）可能错位
display: none 或 visibility: hidden，否则后续 requestFullscreen() 会静默失败document.querySelector('iframe').parentElement 动态取父元素再绑定——DOM 尚未就绪时取到的是 null，应提前写死结构或等 DOMContentLoaded 后操作requestFullscreen() 必须由用户手势同步触发，且目标必须是可见容器
双击回调里调用 container.requestFullscreen() 是唯一可靠路径；任何异步延迟（setTimeout、Promise.then）、生命周期钩子（load、DOMContentLoaded）或媒体事件（play 回调）都会导致 NotAllowedError。
- 目标容器推荐用语义化元素（如
<main id="iframe-wrapper"></main>），而非document.body或document.documentElement—— Safari 会拒绝后者 - 调用前加兼容判断：
if (container.requestFullscreen) { container.requestFullscreen(); }，防止旧 Safari 报undefined is not a function - iframe 自身要带
allowfullscreen属性，否则即使容器全屏，iframe 内容仍可能被限制（尤其跨域场景）
全屏状态切换后，iframe 内容常被裁切或滚动异常
进入全屏后，iframe 默认不会自动撑满视口，尤其当它嵌套在 flex/grid 容器中时，容易因父级约束导致高度塌陷或出现滚动条。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- CSS 上强制拉伸：
.iframe-wrapper { position: fixed; top: 0; left: 0; width: 100vw; height: 100vh; z-index: 999999; }，不用100%（它相对父容器，不是视口） - iframe 样式补全：
iframe { width: 100%; height: 100%; border: none; display: block; }，display: block可消除底部默认留白 - 若 iframe 内页面也需响应式，建议其内部设
html, body { height: 100%; margin: 0; }，否则可能出现“全屏了但内容只占一半”
退出全屏后按钮状态不同步、iframe 尺寸没恢复
fullscreenchange 事件只在 document 上触发，且不带源元素信息，必须靠 document.fullscreenElement 实时比对来判断是否退出成功。
- 监听写法必须是：
document.addEventListener('fullscreenchange', () => { if (document.fullscreenElement !== container) { /* 恢复容器原始 class 或 style */ } }); - Safari 下
fullscreenchange触发稍滞后，更新按钮文案或 class 建议包一层Promise.resolve().then(() => {...})避免读到旧值 - 退出逻辑别只依赖 Esc 键——用户也可能点按钮或调用
document.exitFullscreen()，所以按钮点击事件里要统一处理“进/出”状态切换，不要拆成两个独立函数
双击全屏看似简单，真正卡住人的地方从来不是 JS 行数，而是容器是否挂载、是否可见、是否在手势上下文中调用，以及退出后 CSS 状态能否干净还原。这几个点漏掉任意一个，都会表现为“点一下没反应”或“全屏了但显示不全”。
